The 640 MEG Shareware Studio 2

home *** CD-ROM | disk | FTP | other *** search

/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / sbbs_115.zip / SDOC_115.ASC < prev next >

Wrap

Text File | 1992-01-12 | 454KB | 10,791 lines

│ │ │ ▄▄▄▄ │ ▄ ▀ │ SuperBBS Bulletin Board Software. ▀▀▀▄ │ ▀▄▄▄▀ │ Release 1.15, date: Jan 15, 1992 │ ▄ ▄ │ Copyright (C) 1990-1992 █ █ │ █ █ │ █▄▄▄▀ │ │ SuperBBS program and utilities are copyrighted by: ▄▄▄▄ │ ▄ █ │ - Risto Virkkala █▀▀▀ │ - Aki Antman █ │ │ Some external utilities based upon code written by: ▄▄▄▄ │ ▄ │ - Jouni Malinen █▀▀ │ █▄▄▄ │ Documentation is copyrighted by: │ ▄▄▄▄ │ - Frank Hemmelder ▄ █ │ █▀█▀ │ █ ▀▄ │ │ ▄▄▄▄ │ Documentation release V1.15FH03. ▄ █ │ █▀▀▀▄ │ █▄▄▄▀ │ │ ▄▄▄▄ │ SuperBBS, the specific external utilities and this ▄ █ │ documentation are protected under the copyright laws █▀▀▀▄ │ of Finland and other countries. You are not authorized █▄▄▄▀ │ to copy, edit or modify these files without written │ permission of the copyright holders. ▄▄▄▄ │ ▄ ▀ │ ▀▀▀▄ │ All none SuperBBS programs mentioned in this ▀▄▄▄▀ │ documentation are owned by their respectie owners. │ All programs are (C)opyrighted. │ │ │ │ This documentation is for release 1.15 of SuperBBS. │ Woerden, Holland, January 15, 1992 │ Table of contents ============================================================== Chapter Description Page ------------ ------------------------------------- ------ 1 SuperBBS General information 002 1.1 General information 002 1.2 SuperBBS credits 003 1.3 SuperBBS addresses 003 1.4 How to contact us 004 1.5 Legal stuff 004 1.6 How to register 005 1.6.1 Registration in Finland only 006 1.6.2 Registration abroad 006 1.6.3 Site registrations 007 1.7 Differences registered/evaluation 007 1.8 Distribution files 008 2 Installation 009 2.1 General information 009 2.2 Software requirements 009 2.3 Hardware requirements 010 2.4 Unpacking the software 010 2.5 Configuring SuperBBS 011 2.5.1 ? 013 2.5.2 Registration 013 2.5.2.1 Information 013 2.5.2.2 Registration 013 2.5.3 Messages 014 2.5.3.1 Message areas 014 2.5.3.2 Global options 018 2.5.3.3 Netmail 021 2.5.3.4 QWK setup 022 2.5.4 Files 024 2.5.4.1 File areas 024 2.5.4.2 Global options 026 2.5.4.3 Internal protocols 029 2.5.4.4 External protocols 030 2.5.5 Modem 034 2.5.5.1 Initialization 034 2.5.5.2 General options 035 2.5.6 Other 035 2.5.6.1 New users 035 2.5.6.2 General options 038 2.5.6.3 On/Off settings 042 2.5.6.4 Restrictions 045 2.5.6.5 Alt-F keys 047 2.5.6.6 String configuration 047 2.5.6.7 Door configuration 048 2.5.6.8 Multi node configuration 051 2.5.6.9 Event editor 051 -------------------------------------------------------------- SuperBBS v1.15 documentation Page i Chapter Description Page ------------ ------------------------------------- ------ 2.5.7 Colours 052 2.5.8 Limits 054 2.5.9 Paths 056 2.5.10 Quit 058 2.6 Environment variable 059 3 Language support 060 3.1 General information 060 3.2 Lconfig.exe 060 3.2.1 Path & description 061 3.2.2 Logon strings (Page 1) 063 3.2.3 Logon strings (Page 2) 065 3.2.4 Message base strings (Page 1) 066 3.2.5 Message base strings (Page 2) 068 3.2.6 Message base strings (Page 3) 070 3.2.7 Message reading command keys 071 3.2.8 File area strings (Page 1) 073 3.2.9 File area strings (Page 2) 075 3.2.10 Other strings (Page 1) 077 3.2.11 Other strings (Page 2) 079 3.2.12 Other strings (Page 3) 081 3.2.13 Status string configuration 083 3.2.14 Month names 085 3.2.15 Weekday names 085 3.2.16 BBS List strings 085 3.2.17 Multi line status strings 086 3.2.18 QWK strings 087 3.2.19 A little help 088 3.3 Control codes in strings 089 3.4 Language.ctl file 090 3.5 Hints and tips 091 4 Converting from other software 092 4.1 General information 092 4.2 Converting from QBBS or RA 092 4.3 Converting from other software 092 5 Menus 093 5.1 General information 093 5.2 Menu commands 095 5.3 Menu templating 115 5.4 Changing hardcoded menu options 117 5.5 Include1.mnu 118 -------------------------------------------------------------- SuperBBS v1.15 documentation Page ii Chapter Description Page ------------ ------------------------------------- ------ 6 Control codes 119 6.1 Control codes in menu and textfiles 119 6.2 ^F codes 119 6.3 ^K codes 120 6.4 ^X, ^C, ^P and ^A keys 121 6.5 ^O control codes 122 6.6 Additional control codes 122 7 Message base 124 7.1 General information 124 7.2 Sysop keys available 125 7.3 QWK offline mail system 125 7.4 Group messages 127 7.5 Netmail 127 7.6 Echomail 128 7.7 Nodelist support 129 7.8 Search userlist 129 8 Files base 130 8.1 General information 130 8.2 Extract and view option 130 8.3 Uploader to Files.bbs 131 8.4 Files.ctl 131 8.5 New list option /N 132 8.6 Download counter 132 9 Support files 133 9.1 General information 133 9.2 ANSI and ASCII support files 133 9.3 .CTL, .LNG and .BBS support files 138 10 Questionnaire language 143 10.1 General information 143 10.2 Available commands 143 10.3 Newuser.q-a and Expired.q-a 146 10.4 Questionnaire example 147 11 Running SuperBBS 149 11.1 General information 149 11.2 Commandline options 149 11.3 Online Sysop keys 151 11.4 User's online keys 153 11.5 Errorlevels 154 11.6 Yell and chat 154 11.7 Alias system 155 11.8 View a certain file 155 11.9 Menu to run 156 11.10 Expiration date 156 -------------------------------------------------------------- SuperBBS v1.15 documentation Page iii Chapter Description Page ------------ ------------------------------------- ------ 12 Multitasking and multiline 157 12.1 General information 157 12.2 Multiline configuration 157 12.3 Multitaskers & networks 159 12.4 Messagebase locking 159 13 Specific external utilities 160 13.1 General information 160 13.2 Userpack.exe 160 13.3 Sbbsuser.exe 161 13.4 Sbbsutil.exe 163 13.5 Usersort.exe 164 13.6 Sbbsmenu.exe 164 13.6.1 File commands 165 13.6.2 Text commands 166 13.6.3 Menu commands 166 13.6.4 Prompt 167 13.6.5 Setup 167 13.7 Sbbsnode.exe 167 13.8 Snetmgr.exe 168 13.8.1 Users online 168 13.8.2 Last callers 168 14 Useful information 169 14.1 Batchfiles 169 14.2 Equipment 173 14.3 Turbo pascal errors 173 14.4 Credits 175 15 SuperNet 176 A Menu list 178 B Bugreport & Suggestion form 180 -------------------------------------------------------------- SuperBBS v1.15 documentation Page iv Chapter 1. SuperBBS general information ============================================================== 1.1 General information -------------------------------------------------------------- Welcome to this release of SuperBBS. This version is named 1.15, although the latest official release was 1.12. There are so many new options in this release, that we decided to change the number to 1.15, instead of 1.13. You might have seen a beta release with the number 1.13, but with the gamma release this was changed to 1.15. Please read the documentation care- fully to get informed about all new options of the SuperBBS program or the changes in the already available options. SuperBBS is a QuickBBS (TM) look alike software program, but with many different options. It uses the Hudson type message base, meaning that you have only 5 files, which contains your complete messagebase. Menu and textfiles options are very flexible and a Sysop can build his BBS system as complex as he/she wants. Many doors (= external programs like utilities and games) are available for use in SuperBBS. SuperBBS is distributed as Shareware. This means you can test the software for 30 days, before you either have to register or to stop using the program. Not registering the program but using the program after 30 days could mean that a next version of SuperBBS will not be distributed as Shareware. Please support Shareware and register your software after the trail period. SuperBBS, it's specific external utilities and the documenta- tion are protected under the copyright laws of Finland and other countries. You are not allowed to modify, edit, change, loan etc. these files without written permission of the copyright holders. Any violation of this copyright will be reported to the authorities. This includes patching an un- registered version of SuperBBS to make it appear registered. An international Fidonet echomail link called SUPERBBS has been set up and is available to most countries. If you have problems, questions or remarks about SuperBBS and it's util- ities, please search for this area on a BBS near you. Most SuperBBS sites have this echo available. There is also a SuperBBS SDS area available. Available to all SuperBBS sysops is the network SuperNet. This is an international fido like network for SuperBBS sysops all over the world. It has it's own echomail areas available for reporting bugs, finding hints and other useful information. Supernet is available to registered and unregistered Sysops, although you should register after a trail period of 30 days! -------------------------------------------------------------- SuperBBS v1.15 documentation Page 002 SuperBBS will be distributed accordingly: - Alpha versions Not available. - Beta versions Available to all BETA testers. - Gamma versions Available to all registered Sysops. - Normal versions Available to everybody, including non-registered users. Updated documentation will only be available with the official releases. Beta and Gamma releases will have a special what's new file included. 1.2 SuperBBS credits -------------------------------------------------------------- Here are the credits for SuperBBS: Programming and design: Aki Antman and Risto Virkkala Documentation: Frank Hemmelder Protocol Engine (PE): Copyright Joaquim H. Homrighausen, ALL RIGHTS RESERVED. 1.3 SuperBBS addresses -------------------------------------------------------------- How to reach the SuperBBS programmers: BBS name...........: SuperBBS HQ Telephone number...: +358.0.341.1398 Modem speed........: HST / V.32 DS Online hours.......: 24 Hrs Fidonet number.....: 2:220/620 SuperNet number....: 42:1200/101 Sysop..............: Aki Antman or by mail: Address............: Aki Antman (SuperBBS H.Q.) Porslahdentie 23 G 40 SF-00980 Helsinki Finland, Europe -------------------------------------------------------------- SuperBBS v1.15 documentation Page 003 How to reach the SuperBBS documentation writer: BBS name...........: NNN SuperBBS Telephone number...: +31.3480.24801 Modem speed........: V.32bis / V.42Bis / MNP5 Online hours.......: 24 Hrs Fidonet number.....: 2:500/239 SuperNet number....: 42:1100/101 Sysop..............: Frank Hemmelder or by mail: Address............: Frank Hemmelder (NNN SuperBBS) Lekoord 43 3448 VS Woerden Holland, Europe 1.4 How to contact us -------------------------------------------------------------- If you need to come in contact with us, there are several ways available. Here they are: - Send a letter to the address of the SuperBBS authors. Please include payment to return an answer. - Send a netmail message to the SuperBBS HQ BBS. Please include a Fidonet address to where the answer should be send. - Write a message in the international SuperBBS echomail area available in most countries. Your answer will also be posted here. Depending on the location you posted your message, this could take some time. - Write a message in the SuperNet echomail areas, available on most registered SuperBBS sites. FidoNet is a worldwide network, and contains over 8,000 sys- tems around the world, so it is easy to post a message from any country through Fidonet. 1.5 Legal stuff -------------------------------------------------------------- Disclaimer: The authors of SuperBBS and the utilities are NEVER respon- sible for any damage occurring through the use of SuperBBS and/or utilities. We only guarantee that SuperBBS will take up space on your harddisk. It has been tested on several systems and it works there, but this doesn't mean it won't destroy your HDU or kill your cat or dog. Use at your own risk! -------------------------------------------------------------- SuperBBS v1.15 documentation Page 004 However, if you do find an undocumented feature (= bug) or are having problems with running SuperBBS on your system, we would like to hear from you. Please contact us, so we might be able to fix the problem. SuperBBS may not be used in any UNLAWFUL manner or illegal activity. If this will happen, we will always inform the local authorities. You are not allowed to modify ANY of the executable files of SuperBBS or to change this documentation. The authors don't guarantee any future releases of SuperBBS. All files belonging to the SuperBBS package are copyrighted 1990-1992 by Aki Antman and Risto Virkkala. Documentation is copyrighted 1991-1992 by Frank Hemmelder. You are not allowed to modify, patch, disassemble (or anything like that) these files without the written permission from the copyright holders. You are not allowed to ship the SuperBBS programs, or part of the programs, in other software/hardware packages without written permission from the copyright holders. Sysops of bulletin boards are allowed to post the SuperBBS software package for download to their users in an unmodified version and as long as no charge is asked for downloading the software. It is not allowed to add BBS commercials to the software archive. The use of a ZIP or ARJ header is however allowed. Sysops should make it possible for all their users to download the SuperBBS package if requested by the user. 1.6 How to register -------------------------------------------------------------- SuperBBS is released under the ShareWare concept, so you can try it for 30 days before you have to register this product or stop using it. If you are using this software after the 30 days trail limit, you MUST register. This software is not cripple in any way. You can test the whole package. Please support the shareware concept. Through this concept it is possible to test the software before paying for it. If you decide the software is 'just what you wanted', you will need to register. If you don't register, you will violate the Shareware concept. This could mean that the next version will be a commercial one, so you won't be able to try it before buying. > Register ShareWare - Guarantee the future of SW programs. < -------------------------------------------------------------- SuperBBS v1.15 documentation Page 005 Registration of SuperBBS entitles you to use the software after a period of 30 days. It will also give you access to the SBBS Gamma releases, which are only available to registered users. Registration entitles you to use any SuperBBS release up to version 1.99. (Currently v1.15) This will take a long time and many new releases and improvements. 1.6.1 Registration in FINLAND only -------------------------------------------------------------- Send FIM 200,- to the account: '710125 - 313639 STS', _PAY- ABLE_ to Risto Virkkala and send in the registration form with the following information: - The Sysop name to register SuperBBS to - The BBS name to register SuperBBS to Please note that upper and lower case are different! - Your real name - Your address - Your voice and data phone numbers - Your FidoNet address (if available) When we received your payment, your registration code will be posted to you. This can take some time, so please be patient. 1.6.2 Registration abroad -------------------------------------------------------------- Send US $50 cheque or money order to the SuperBBS HeadQuarters address posted. Make cheques payable to: Risto Virkkala. Make sure your shipment arrives in good order. Creditcards can't be accepted at this moment. Please include the following information. Note that upper and lower case are different with the registration names! - The Sysop name to register SuperBBS to - The BBS name to register SuperBBS to - Your real name - Your full address including Country - Your full (international) voice and data phone numbers - Your Fidonet address (if available) If you are part of Fidonet, please include your BBS opening hours, so we can crash your registration key to your board. This will give a faster turn around time then by mail. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 006 You will receive your registration key after we have received your money. Please do allow some time for processing and handling. Registrations are also possible at some of our Support sites. Please check the file HOWTOREG.TXT included in the main BBS archive for more information. 1.6.3 Site registrations -------------------------------------------------------------- Site registrations are also available: 5-9 boards..... US $45 10-more boards..... US $40 Please authorize one of you to register all boards on the site. This person has to send us the information and money for the registration and we will send him/her the registration codes for all boards. Do not send the money separately! Send money and information required to the SuperBBS HeadQuarters. Site licenses are not available at the Support sites. 1.7 Differences registered/evaluation -------------------------------------------------------------- There are some differences between the registered version of SuperBBS and the evaluation copy. The evaluation copy is however not crippled and can be used to evaluate the program in all available aspects. The only differences between evalu- ation and registered copies are: When somebody is login in to your system, a message will be displayed to him/her: Registered version: "SuperBBS v1.15, registered to: <Your name>" Unregistered version: "SuperBBS v1.15, unregistered evaluation copy." This message will also be displayed if you choose the display version number menu item. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 007 The tearline in the echomail areas originating from your board will look like: Registered version: "--- SuperBBS v1.15 (Reg)" Unregistered version: "--- SuperBBS v1.15 (Eval)" 1.8 Distribution files -------------------------------------------------------------- SuperBBS is distributed in an archive named 'SBBS_nnn.xxx', where nnn is the version number and xxx the archive type. Please do not modify this file in any way. Do not add your own adds to the archive. (Some archivers do however allow you to add a archive header.) The SuperBBS archive file should have the following files: BBS.EXE Main executable file OVRBBS.OVR Overlay file (only in overlay version) CONFIG.EXE Configuration program file LCONFIG.EXE Language/String configuration file YELLCFG.EXE Yellsound editor program file EXTPE.EXE Protocol driver SPROTO.$$$ Example for external protocols USERFIX.EXE User database fixer USERPACK.EXE User database packer USERSORT.EXE User database sorter SBBSUSER.EXE User database editor SBBSUSER.HLP SBBSUSER.EXE help file SBBSUTIL.EXE SuperBBS utilities SBBSMENU.EXE SuperBBS menu editor SBBSNODE.EXE Nodelist converter STOP.EXE Top xx list generator SNETMGR.EXE Multi line utility Also included is an archive with startup files, which makes it possible for you to start a bulletin board in a short time. Documentation concerning registration, update information, technical descriptions and menu types is also included. If you received more or less files, you have a modified archive. You should not distribute this file any further and get a complete version from one of the distribution nodes. You may distributed the unregistered version of SuperBBS freely, as long as no fee is asked or any profit is made. Please make sure all users of your bulletin board are able to download the SuperBBS archive. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 008 Chapter 2. Installation ============================================================== 2.1 General information -------------------------------------------------------------- SuperBBS is a very flexible program. Please read this documen- tation carefully. Although the program is complex, it is not hard to set up a bulletin board system with it. Have a look at the samples if you are new to running a bulletin board. This will help you to get a BBS up and running in a very short time. If you do however run into problems, consult this manual again and if you still have problems, contact one of the support boards or the authors. The SuperNet echomail area is also available to ask questions and it often will give you hints from other (more experienced) SuperBBS users. 2.2 Software requirements -------------------------------------------------------------- Besides the SuperBBS files, you will need some external files before you can run SuperBBS. These files can differ from system to system, depending on the way you have set it up. You will at least need these files, or compatible: MS-Dos Sounds logical, without this your system won't even run (or not with an operating system SuperBBS will run in). You'll need version 2.0 or higher. SuperBBS has been tested with Ms-Dos up to version 5.00, but version DOS 3.3 to 5 is recommended. Su- perBBS has also been tested with 4DOS from JP Software (TM) and works fine with ver- sion 4.00 and older. X00.SYS Fossil communications driver, a good re- placement is BNU. SuperBBS will not run without this file! (Except in Local mode.) QUICKED.EXE The full-screen editor. (This file is optional.) THEDRAW.EXE Or any other ANSI/ASCII text editor. This program will help you design your ANSI and ASCII support files. (This file is optional.) Most QuickBBS files work with SuperBBS. Please keep in mind that SuperBBS is much bigger than QuickBBS and there could be programs which will work perfect on a QuickBBS system, but not, or not complete, on a SuperBBS system, because there are many differences between the two programs. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 009 2.3 Hardware requirements -------------------------------------------------------------- Some hardware is needed to run SuperBBS. SuperBBS uses about 250 Kbyte base memory and can use EMS memory for the overlay file. This memory requirement is for SuperBBS only. When run from a batchfile, you will need to reserve more memory. Other requirements are: Harddisk A harddisk with at least 2 MB of free diskspace is needed to set up SuperBBS. You'll probably need more if you set up a lot of utilities to run under SuperBBS and have many mail areas. A system with 70 mail areas (6000 messages), 30 file areas and 10 online games uses around 20 MB of disk space for the systemfiles and support programs. Hayes Modem A Hayes compatible modem, either internal or external, is needed. Speeds up to 38400 Bps are supported. When running a multi-node system with Desqview (TM) or Windows (TM), a 80386DX processor is recommended. Running single line is possible on a slow XT, although a 80286-12 or higher is preferred. Running multiline in a network is also possible. 2.4 Unpacking the software -------------------------------------------------------------- Move your SuperBBS archive to the main directory you want your BBS files in. (In our example C:\SBBS) Unpack the archive. You can move the documentation files to another directory if you want. Make a directory for your menu files, your textfiles, the TEMPDIR and a working directory. Also create a directory for your message files if you don't want them in your main BBS directory. You would get something like this (for single line operations only): C:\SBBS C:\SBBS\TEXT C:\SBBS\MENU C:\SBBS\MAIL C:\SBBS\TEMP C:\SBBS\WORK C:\SBBS\NODELIST (Optional) C:\SBBS\ATTACH (Optional) Now you need to start the configuration program CONFIG.EXE. Please refer to the part of this documentation concerning the CONFIG.EXE program. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 010 The directory set up for the multi-node operations is a bit more difficult. You will have to make a directory for every node you plan to run, even if it's only a local node. Your directory set up could look like this: C:\SBBS C:\SBBS\LINE1 C:\SBBS\LINE2 C:\SBBS\LINE3 C:\SBBS\MAIL C:\SBBS\TEMP1 C:\SBBS\TEMP2 C:\SBBS\TEMP3 C:\SBBS\WORK1 C:\SBBS\WORK2 C:\SBBS\WORK3 C:\SBBS\NODELIST (Optional) C:\SBBS\ATTACH (Optional) E:\ Place the executable programs in the SBBS directory and set your path statement showing this directory. Run the configur- ation program from the single line directories, i.e. line1, line2 and line3 in this example. You will have to setup a TEMP directory and a WORK directory for every line in use. The E:\ drive is a RAM disk and is the common directory for all nodes. You can also use a normal disk if no RAM drive is available. But a RAM disk is faster. 2.5 Configuring SuperBBS -------------------------------------------------------------- CONFIG.EXE is the main installation program for SuperBBS. You need to run this program to set all settings correct for your system. You can run the configuration program as often as you like, it will ask you if you want to save the current con- figuration when you exit the program. As of this version 1.15, the SuperBBS configuration program has a new, more modern look. When you start CONFIG.EXE, you will be presented with the following options and sub-options: ? (2.5.1) Registration (2.5.2) Information (2.5.2.1) Registration (2.5.2.2) -------------------------------------------------------------- SuperBBS v1.15 documentation Page 011 Messages (2.5.3) Message areas (2.5.3.1) Global options (2.5.3.2) Netmail (2.5.3.3) QWK Setup (2.5.3.4) Files (2.5.4) File areas (2.5.4.1) Global options (2.5.4.2) Internal protocols (2.5.4.3) External protocols (2.5.4.4) Modem (2.5.5) Initialisation (2.5.5.1) General options (2.5.5.2) Other (2.5.6) New users (2.5.6.1) General options (2.5.6.2) ON/OFF settings (2.5.6.3) Restrictions (2.5.6.4) Alt-F? keys (2.5.6.5) String configuration (2.5.6.6) Door configuration (2.5.6.7) Multinode configuration (2.5.6.8) Event editor (2.5.6.9) Colours (2.5.7) Configuration 1 (2.5.7.1) Configuration 2 (2.5.7.2) Limits (2.5.8) Paths (2.5.9) Quit (2.5.10) The numbers between brackets are the chapter numbers for easy references. Moving around the different options is done by the cursor keys. To open a certain option you have to press ENTER. Press- ing ESC will bring you one step back, or will exit the pro- gram. You will be asked if you want to save the configuration before you exit the program. All configuration info will be saved in several files. These files should never be deleted, unless you want to start all over again. These files are: CONFIG.BBS Main configuration file with most information about your BBS settings. SCONFIG.BBS More configuration information. FLSEARCH.BBS Information about your files areas. SPROTO.BBS Information about any external proto- cols you might have installed. LIMITS.BBS Information about the limits of the user levels. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 012 DOORCFG.BBS Information about the installed doors on your system. TIMELOG.BBS Information on the usage of your sys- tem. All available configuration options will be explained below. The following notation standard will be used: Type.........: Name of the current option Description..: Explanation of the option and it's function in the BBS program. Options......: The available options. 2.5.1 ? -------------------------------------------------------------- This will give you some information about the SuperBBS program and the makers. No further sub-options available. 2.5.2 Registration ------------------------------------------------------------- Here you will enter the information about your registration. You have to register SuperBBS after a 30 day trail period, or you have to stop using it. 2.5.2.1 Information ------------------------------------------------------------- The information option will give you some information on how to register. No further sub-options available. 2.5.2.2 Registration ------------------------------------------------------------ The registration option has the following fields available: Type.........: Sysop name Description..: The name of the person who registered the SuperBBS program. This must be exactly the same as on your registration, otherwise the system will not display the 'registered' message. Normally this is the Sysop's name. Any message written to 'Sysop' will be addressed to this name. Options......: Name Type.........: System name Description..: The name of your system as set on the registra- tion form. This has to be an exact match, or SuperBBS will not display the 'registered' message. Options......: Name -------------------------------------------------------------- SuperBBS v1.15 documentation Page 013 Type.........: System location Description..: Place where your BBS system is located. Your free to enter what you like in this field. Options......: City Type.........: Registration code Description..: The registration code as supplied by the authors of the SuperBBS program. This code will unlock all features in SuperBBS only available to registered users. Leave this the way it is if you run an evaluation copy. Options......: Registration code Type.........: Beta code Description..: Registration code for BETA testers of the SuperBBS program. (Currently there are BETA testers enough. Only when you run a special configuration, like a network, you could apply for a BETA tester code.) This code only works if code A is available also. Options......: Registration code 2.5.3 Messages -------------------------------------------------------------- SuperBBS allows the use of 200 message boards. It has a build in offline reader, QWK, so you can let your users download the messages and read them offline. 2.5.3.1 Message areas -------------------------------------------------------------- SuperBBS allows you to setup 200 different message areas. All these areas have their own security levels and flagsettings. SuperBBS even allows you to have different origin lines for every message area. (See ECHOORIG.CTL in the control file part of this documentation.) You can move around the fields through the use of the arrow keys. The [PgUp] and [PgDn] keys will skip you to the previous or next message area. [ESC] will return you to the main menu. With [F1] you can move to an area by entering the area number. Type.........: Message board name Description..: Name assigned to the current message area. leave this blank if you want to skip this area. This name will appear in the change message area menu build into SuperBBS. It can also be displayed in your menus or textfiles when using menu templating. Options......: Name -------------------------------------------------------------- SuperBBS v1.15 documentation Page 014 Type.........: Type of messages Description..: SuperBBS has three different type of messages. Which to use depends on the way you want to use the message area. The available types are: 1. Standard. This type is used for local areas on your bulletin board system. 2. Netmail. This type is used for your netmail area(s). You should have defined the area number in the netmail part of the con- figuration program. User's will be asked to enter an address (fidonet style) where to send the message. 3. Echomail. This type is used for echomail messages. These are mostly public and an origin line will be appended to every message written in this type of area. Most echomail areas don't allow the use of aliases. Normally you would have 1 netmail area, a couple of local areas and some echomail areas. Options......: 1,2 or 3 Type.........: Status of messages Description..: There are four different type of messages in SuperBBS available, depending on the type of message area you choose in the above option. The types are: 0. Both public & private This type of messages is normally used in your local message areas. The user will be asked if the message is private or not. private messages can only be read by the writer, the addressee and people having Sysop access level. 1. Private messages only This type is mostly used in your netmail area and the local Sysop area. All the messages will be private and can only be read by the writer, addressee and people having Sysop level. Note that private mes- sages send to other systems can be read by the Sysops where the message is passing through. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 015 2. Public messages only This type of messages is mostly used in echomail areas, since the message can be, and need to be, read by everyone. No pri- vate messages are allowed in (Fidonet) echomail. 3. Read only messages This type of messages can be read by everyone having access, but no messages can be written and no replies are possible with this type of messages. People having Sysop level can read all private and public mail, even if this mail is not addressed to them or originating from them. Please tell your users this is the case, so they know. Options......: 0,1,2 or 3 Type.........: AKA to use (0 = primary) Description..: SuperBBS allows you to have different addresses for every mail area you have defined. (Mostly only useful on Echomail areas.) The 0 stands for the primary address, see netmail part of configuration, while 1 to 5 stands for the AKA's. This allows you to have an area for one fidonet and one for another. Options......: 0,1,2,3,4 or 5 Type.........: User names Description..: This option allows you to give users the option to use their alias in the 'From' field of the message. Please note that most echomail areas don't allow the use of an alias. You have the option to allow several aliases, only the alias used in the BBS, force the use of an alias or don't allow aliases. Options......: No alias/Ask alias/Force alias/Alias & name Type.........: Combined Description..: Will the message area be available from the combined board. This special message area, number 0, displays all available messages to the user in numerical order and not separated by area. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 016 Type.........: Default combined board Description..: If you want this message area to be in the combined board by default, switch this option on. Note that the user can still deselect the area. Options......: Yes/No Note that currently the combined area select is also used as the area select for the QWK mail reader. Type.........: Read security level Description..: Security level of the user needed to read mess- ages in this area. If the user doesn't have the correct level, he/she will be displayed a mess- age, stating that access has to be granted. Options......: Security level Type.........: Read flags A to D Description..: These are the flagsettings you can use to give somebody permission to read a message in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Write security level Description..: Security level of the user needed to write messages in this area. If the user doesn't have the correct level, he/she will be displayed a message, stating that access has to be granted. Options......: Security level Type.........: Write flags A to D Description..: These are the flagsettings you can use to give somebody permission to write a message in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Sysop security level Description..: Security level of the user needed to have the extra Sysop options available in this area. User's who have this access will be able to read, delete, edit, copy and change attributes of all messages, private or public, in this area. Options......: Security level Type.........: Sysop flags A to D Description..: These are the flagsettings you can use to give somebody permission to sysop level in this area. Options......: Flagsettings (X = On/- = Off) -------------------------------------------------------------- SuperBBS v1.15 documentation Page 017 All these options have to be set for every message area you want to use. You can change the settings at any time. If you want to delete a message area, just delete the area name. SuperBBS will not show the area as long as the area name is blank. 2.5.3.2 Global options -------------------------------------------------------------- Type.........: Net/echo exit Description..: This option tells SuperBBS to exit with a special errorlevel if the user entered net and/or echomail messages. This allows you to run the mail processor to pack the mail. SuperBBS will exit with the following error- levels: 5 - Both net and echomail entered 4 - Only echomail entered 3 - Only netmail entered This allows you to adjust your batchfile in the correct way. Options......: Yes/No Type.........: Allow @ control characters Description..: Special @ control characters are replaced in a message with a certain value, depending on the character used. It is possible for users who know these codes to generate messages like: Hey dude, what's ....... for a password. The ..... is then replaced by the current user's password. Although the writer of the message couldn't see the next user's password, the user still might think so. The message writer used a control character to display the current user's password. So use this option with care, not every user is as honest as you. Options......: Yes/No Type.........: Check mail at logon Description..: If this option is enabled, SuperBBS will scan the message base for any unread messages addressed to the user (or it's alias) and dis- play them. The user has the option to read them or to skip them. If disabled, no messages will be scanned. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 018 Type.........: Fast mail check Description..: SuperBBS normally scans the whole messagebase for messages unread by the user. With this option enabled, it will start at the last read pointer, making it faster, but less accurate. Some echomail processors do weird things with the lastread pointers, causing messages to be missed in the mail scan. This is not a SuperBBS problem, but a problem with the echomail pro- cessors. Even with over 5000 messages the nor- mal message scan will only take a couple of seconds to complete. Options......: Yes/No Type.........: 8bit --> 7bit in echos Description..: SuperBBS allows the use of 8 bit characters and can convert these to 7 bit in echomail areas. In some countries are 8 bit characters not allowed. If you switch this function off, 8 bit characters can not be used in echomail areas. (SuperBBS will translate them to 7bit charac- ters.) Options......: Yes/No Type.........: Coloured quotes in messages Description..: You can now display quotes in messages in another colour. You will have to use ANSI to see the colours. SuperBBS will scan for the > sign, to determine if the line is a quote or not. Options......: Yes/No Type.........: No group mail at logon Description..: SuperBBS allows the use of group messages, messages to all users, or certain security levels. To scan for these messages, you will have to set this option to No. If set to Yes, no group messages will be scanned at logon. Options......: Yes/No Type.........: No userlist in type 27 Description..: If a user enters a name of a user in a local mail area and this name does not exist, Super- BBS allows the user to scan the user list for the correct name. If this option is enabled, SuperBBS will not display the userlist. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 019 Type.........: Match senders zone Description..: If your part of Fidonet and have more addresses, AKA's, SuperBBS can match the zone of the message your replying to, if their is an AKA in that net. Take for example a message from net 2. SuperBBS will use your zone 2 address to reply on the message. If the orig- inating message would come from a zone 42 sys- tem, SuperBBS would use your zone 42 address. If you receive mail from a zone 77 system, SuperBBS will use your main address to reply, if you don't have a zone 77 address. Options......: Yes/No Type.........: Real message numbers Description..: Normally the messages in SuperBBS are numbered from 1 to xxxxx in ascending order. Every new message will get the latest message number + 1. If you enable this option, SuperBBS will number the messages per area. So area 1 will have messages numbered 1 to xxxx. So will area 2 and so on. Internally SuperBBS still uses the nor- mal message numbering system, and it does so in area 0, the global read area, but for the user it will number every area from 1 to xxxx, mak- ing it easier to read individual messages or the last xx messages. Note that this only applies to the interface to the user. For your echomail processor or any other program, Super- BBS still uses the normal count. Options......: Yes/No Type.........: Quote string Description..: String which will be displayed when quoting a message. This string will be placed in front of the messagelines you are quoting. The standard quote string in SuperBBS will give you the two first characters from first and lastname of the writer of the message your quoting. Options......: Quote string (Example: >) Type.........: Comment answer board Description..: Message area number where all the replies on the logoff comments are stored. If you set this to 0, no replies are possible. Normally you would use your local 'general' message area for this. Options......: 0 = Not in use n = Message area number -------------------------------------------------------------- SuperBBS v1.15 documentation Page 020 Type.........: Password failure board Description..: Number of the message area where the user can leave a message if he/she forgot his/her pass- word and sends a message to the Sysop. If you set this to 0, no messages will be allowed. The user will be logged off after writing the optional message. Mostly the Sysop area is used for this type of messages. Options......: 0 = not enabled n = message area number Type.........: Message after page board Description..: Message area number where the messages from user's who tried to page you are stored. If a user tries to page you and you don't react, SuperBBS will ask the user if he/she would like to leave a message. Options......: 0 = not enabled n = message area number Type.........: Group mail security Description..: Security level needed to write a group mail message. Group mail messages are messages to all users or certain security levels. (See the message base chapter for more information.) Options......: Security level 2.5.3.3 Netmail -------------------------------------------------------------- This part is only of interest to you if you are part of Fidonet or another network. Systems in a network exchange netmail and echomail and are using a network address. In the netmail part you will specify your address and your AKA's. AKA's are fake addresses used by some BBS systems which have a node address in more than one (Fidonet like) network or zone. You can obtain a network address at a network administrator. Ask a local sysop who is connected to a network how to contact the administrator. Do not use a number of your own choice. If you are no part of a network, leave the fields as they are. An example: 2:220/620. This is a BBS in Europe (Zone 2). Net 220 is in Finland and number 620 is Aki's system. SuperBBS has Nodelist support and also Point addresses are supported. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 021 Type.........: Main address Description..: The number of your main address. This number consist of four parts: zone, net, node and pointnumber, although the pointnumber is left out for most BBS systems. Options......: Zone, net, node and pointnumber Type.........: AKA Address #1 to #5 Description..: See main address. If you don't use more than one address, leave this as it is. SuperBBS does support zone matching when replying to netmail. Options......: Zone, net, node and pointnumber or 0. Type.........: Netmail board Description..: Message base area (between 1 and 200) which will be used to store netmail messages. You also have to setup this area in the message base configuration part of the program as being a netmail area. Set this to an unused area if you are not using netmail. Options......: Message base number (between 1 and 200) Type.........: Crashmail security Description..: Security level needed to send CRASH mail. This is mail which (mostly) is send straight after you leave the BBS. This is depending on how your mailer system is setup. Please consult your mailer documentation for further informa- tion. Options......: Security level 2.5.3.4 QWK setup -------------------------------------------------------------- SuperBBS has a build in mail reader. Mail readers are used to download messages from your system, read them while the user is offline and then upload the replies or/and new messages. This way you can save your users a lot of money on their phonebill and still give them a lot of (echo)mail. As a user you will need a mailreader to read and answer/write the mess- ages. One mailreader for the QWK system is the Silly Little Mail Reader (TM), or SLMR. Currently version 2.0 is available. Other mail readers are available. Also other readersystems are available, but all have to be run as external programs. The QWK mailpackage will contain your welcome and goodbye screens, as well as your NEWS.A?? file, so the user will see these also at his own system when reading mail. QWK message packages are created in the WORK directory set in the configuration of SuperBBS. Please make sure that the directory is setup correctly. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 022 Type.........: Unique BBS ID Description..: This unique BBS ID is used by QWK to name your mail package. Please make sure this is a unique ID, and don't use the example. If a user down- loads mail from more than one system, he/she will have to guess which package came from which BBS by looking at the name. The BBS ID has to be a DOS like filename, since it is used to name your mail package. (That means you can't use the * or ? characters for example.) QWK will add the .QWK extension to your pack- age. Options......: BBS ID name (8 characters) Type.........: Default QWK board Description..: Message board used to store messages which violate the rules, i.e. a bad message, on the BBS concerning read/write access to a certain area. If a message is violating a rule, it will be placed in the default area. Options......: Area number (1 - 200) Type.........: Max. number of messages Description..: Sets the maximum amount of messages to pack in one mail package. Users are able to decrease this amount at the moment they are getting their mail. Options......: Number of messages Type.........: Allow TAG lines Description..: Most mail readers allow you to add a Tagline, a little line of text not concerning the message (in fidonet called a origin line) to your mess- ages. Since most BBS programs, including Super- BBS, will add a origin line, this would mean their are two origin lines in the text, which is illegal in most echomail areas. This option allows you to specify where Taglines may be used. Options......: No taglines Only in local areas Always Type.........: Use ZIP/LZH/ARJ/ARC packets Description..: Here you can specify from which archivers your user can choose to pack his/her mail with. You will need to place the archivers in a directory reachable through your path statement. Options......: Yes/No The QWK support for SuperBBS is based upon MkQwk written by Mark May. Support QWK, get your users to use it. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 023 2.5.4 Files -------------------------------------------------------------- SuperBBS uses a file called FLSEARCH.BBS to store it's file areas in. This file is edited through the file area editor. Please note that this file is not plain ASCII, like the QuickBBS file FLSEARCH.CTL. 2.5.4.1 File areas -------------------------------------------------------------- When you are in the editor's main screen, you'll see one open window. Here you choose the file area to edit and insert and delete file areas. The following keys are active: [RETURN] Edit the area marked by the inverse bar. [INSERT] Add a new area to the file area list. [DELETE] Remove an area from the file area list. [CURSOR] Move around the file area list. [F1] Converts FLSEARCH.CTL to FLSEARCH.BBS. [ESC] Return to main configuration menu. When you choose a file area, a second window will open, dis- playing the options available per file area. You can move around with the cursor keys and pressing [ESC] will return you to the main window. These options are available per file area: Type.........: Name Description..: The name you want to give to the area and which will be displayed at a newfiles scan and if you do an area change through the build in menu command. Options......: Area name Type.........: Directory Description..: The dos directory path to your directory. This is the place where the files are, so people can download them. The backlash at the end of the pathname is optional. Options......: Drive:\Pathname -------------------------------------------------------------- SuperBBS v1.15 documentation Page 024 Type.........: List name Description..: Drive, directory AND filename of the FILES.BBS file for this file area. This option is only needed if you use a CD-Rom drive and want your FILES.BBS in another directory, because a CD- Rom is read only. If you leave this space blank, SuperBBS will look for the FILES.BBS list in the directory given in the directory option above. Options......: Drive:\Pathname\Filename.ext Type.........: Security Description..: The security level needed to access files in this area. Options......: Userlevel Type.........: Age Description..: The lowest age needed to access this file area. this option only works if you have the birthday option in config.exe enabled. Options......: Age Type.........: Flags A to D Description..: Flagsetting needed to gain access to the file area and available files. (X = On/- = Off) Options......: X Type.........: Template Description..: SuperBBS allows the use of menu templating. This means you can have one menu for all avail- able file areas. (See the part of the documen- tation on menus.) If you don't want the file area to be part of the menu templating, disable this option. SuperBBS will save the template information in the user record, so the user will be in the same area when entering the menu the next time. Options......: Yes/No Type.........: Downloads Description..: Option to disable downloads from the area. If set to 'No', no downloads are possible from this area. Options......: Yes/No Type.........: Uploads Description..: Option to disable uploads to the area. if set to 'No', no uploads are possible to this area. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 025 Type.........: Virus check Description..: SuperBBS can scan uploaded files for viruses. if you don't want files to be checked in the file area, disable this option. Options......: Yes/No Type.........: Dupe scan Description..: SuperBBS will check all file areas for dupes when a user wants to upload a file. This could take a long time when you have a CD-Rom player attached to your system. This option allows you to disable this dupe check for the area. Options......: Yes/No Type.........: New scan Description..: When scanning the file areas for new files, you can now disable areas from this scan, for example CD-Rom areas. Areas switched off will not be scanned for new files. Options......: Yes/No Pressing [ESC] will save the information. You can always change the information. Pressing [ESC] from the main window will put you back in the main configuration menu. 2.5.4.2 Global options -------------------------------------------------------------- Type.........: Check files at logon description..: When enabled, SuperBBS will scan the filebase and search for any new file and display these to the user just after the mailscan at logon. Options......: Yes/No Type.........: WatchCD at (un)pack Description..: SuperBBS can watch the carrier while files are extracted and repacked during a virusscan. If a user disconnect during the archive operations, SuperBBS will continue and then, when finished, will bring the system back to it's starting position, ready to accept callers. Options......: Yes/No Type.........: Uploader to Files.bbs Description..: It is now possible to display the name of the uploader in the Files.bbs file just below the filedescription. Note that this option uses the option with the > character. (See below.) Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 026 Type.........: No > in long descriptions Description..: There are two ways of displaying longer file descriptions in the Files.bbs file. The first is through the use of the build in line wrap. SuperBBS will break the line and continue at the next line at the 14th position if the line is longer than the screenwidth. When you use this option you can't use the uploader name in the Files.bbs option. (See above.) The second option is to make use of the > character. Lines preceeded with this character are placed on the 14th position in the Files.bbs file when dis- played to the user. (They should be on the second character in the Files.bbs description when editing the description. See the Files base chapter for more information on these options.) You can toggle between the two options with this configuration option. Options......: Yes/No Type.........: Strict dupe checking Description..: SuperBBS has two ways of checking for dupe files. The first is by name and extension, the second one is on filenames only, without exten- sion. The second one will find a file called SBBS_115.LZH when the file SBBS_115.ZIP is about to be uploaded. The first option would not find the file, because it would look for the complete name, including the extension. If the strict dupe checking is enabled, SuperBBS will only scan for the filename and not on the filename with extension. Options......: Yes/No Type.........: Virus check Description..: When a user has done an upload, SuperBBS has the ability to scan the file for known viruses. The viruscheck will be performed right after the user has done the upload. SuperBBS is very flexible in which scanner to use or what to do with an infected file. You will need the fol- lowing programs (all trademarks of their res- pective companies) when using this option: - PKZIP.EXE - PKUNZIP.EXE - PKARC.EXE/PKPAK.EXE - PKXARC.EXE/PKUNPAK.EXE - LHA.EXE - PAK.EXE - ARJ.EXE - Virusscanner -------------------------------------------------------------- SuperBBS v1.15 documentation Page 027 These files have to be in a directory which is available through the path statement. When a virusinfected file is found, SuperBBS has the option to exit with an errorlevel, so you can do with the file what you want by taking the appropriate steps in your batchfile. Options......: Yes/No Type.........: (Un)pack swapping Description..: Swap part of SuperBBS to EMS or disk when pack- ing or extracting files. Options......: Yes/No Type.........: No unpack before scanning Description..: This option allows you to tell SuperBBS not to unpack any files before a virusscan is done. This is useful for viruscheck programs which can scan inside an archive. Options......: Yes/No Type.........: No files date touching Description..: Do not allow SuperBBS to change the date and time of a file uploaded to your system. Nor- mally SuperBBS will change the date and time of the file so it will be shown in the newfiles scan. If this option is enabled, the original file date will be preserved. But if this is older than the current date, the file will not be shown in the newfiles scan. Options......: Yes/No Type.........: Upload credit multiplier Description..: This option allows you to control the way SuperBBS reacts to an upload. You can give the user back the time spend on the upload or even double or triple it. Or you can do nothing with it. Options......: 0 = Not activated 1 = Returns time spend on upload 2 = Returns double time spend on upload 3 = Returns triple time spend on upload 4 = And so on........ Type.........: Minimum upload space (KBytes) Description..: Minimum diskspace which has to be free before SuperBBS will let the user do an upload. If the space is not free, user's can't upload. Options......: Number of Kbytes -------------------------------------------------------------- SuperBBS v1.15 documentation Page 028 Type.........: Download counter left bracket Description..: SuperBBS has a build in download counter. With this option you specify how the left bracket of the downloadcounter will look like. If left empty, the downloadcounter is disabled. Options......: Left bracket Type.........: Virus found errorlevel Description..: Errorlevel which SuperBBS will use to exit after a virus has been found in a file. This allows you to adjust your batchfile to take care of the virus infected file. Options......: Errorlevel Type.........: Files before ratio check Description..: Number of files a user can download, before SuperBBS will check the file ratio in Kbytes and files. Options......: Number of files Type.........: Maximum file description lines Description..: Number of lines available when giving a file description before or after doing an upload. SuperBBS now wraps the line around if the line is longer than 45 characters. It will display the wrapped text at the right location in the FILES.BBS list. Or you can use the > character. Options......: Number of lines (1 to 5) Type.........: Download counter right bracket Description..: SuperBBS has a build in download counter. With this option you specify how the right bracket of the downloadcounter will look like. If left empty, the downloadcounter is disabled. Options......: Right bracket 2.5.4.3 Internal protocols -------------------------------------------------------------- The internal protocols can be toggled on or off, making it possible to use another Zmodem (or other internal protocol replacement) protocol. The following protocols are available: - Zmodem - Ymodem batch - Xmodem - Xmodem 1K (Ymodem) - Xmodem 1K G - Ymodem-G You can toggle these protocols on or off by changing the Yes to No or vice versa. The internal files are all called by the EXTPE.EXE program. Make sure this file is in your directory. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 029 2.5.4.4 External protocols -------------------------------------------------------------- SuperBBS supports external protocols for downloading and uploading. It is one of the first bulletin board programs to directly support Bimodem as an external protocol. There are 10 definable protocol options available. The configuration of the external protocols is somewhat more complicated. There are several options available here: Command......: Activated Description..: Indicates if the protocol is active or not. If active it will be shown in the up/download list with menu types 32 and 33. They will also be displayed with menu type 48. Options......: Yes/No Command......: Name Description..: The name of the protocol as it will be dis- played in the up/download lists with menu types 32, 33 and 48. Options......: Protocol name Command......: Key Description..: The character which identifies the protocol in the up/download lists with menu types 32, 33 and 48. Options......: Character Command......: Batch Description..: Defines if the protocol is a batch protocol or not. This means if the protocol can download more than one file at a time. (Zmodem can for example, but Xmodem cannot.) Options......: Yes/No Command......: Protocol type Description..: Defines the type of protocol you are using. There are two options. Option one is Bimodem, which you need to use if you install bimodem. The second option is other, which you need to use for all other protocols not using the Bi- modem interface. Options......: Bimodem/Other Command......: Log style Description..: Protocols have different ways of writing a logfile. To support all these logfiles, Super- BBS has the option to support three types of logfiles. These are DSZ, used by many programs, Icom, used by Bimodem, and other. Options......: DSZ/Icom/Other -------------------------------------------------------------- SuperBBS v1.15 documentation Page 030 Command......: Download command Description..: This is the most difficult one of the external protocol installation (with the upload com- mand). Here you specify how the protocol has to be called by SuperBBS. You will have to specify the protocol name and all options needed to run the protocol. See the examples later in this chapter. There are two control codes available to be used in this line: %1 = Filenames %2 = Download limits in bytes If you need to give up the filenames, you can use the %1. If the protocol also accepts the downloadlimit than you can use the %2 in the command line of the protocol. Use the complete pathname for calling the protocol. Options......: Protocol commandline Command......: Upload command Description..: Same as download command, but now for the up- load. Here are also two control codes avail- able. Please note the difference: %1 = Filename or path %2 = Download limits in bytes Use the complete pathname for calling the pro- tocol. Options......: Protocol commandline Command......: Log file name Description..: Name and path of the logfile the protocol cre- ates. Please supply a valid path. Options......: Path\Filename Command......: Control file name Description..: Name and path of the control file SuperBBS creates. This list contains the files to up- /download and should be supplied on the up- /download commandline. Options......: Path\Filename Command......: Efficiency Description..: Efficiency of the protocol in percentage. This is normally somewhere between 95 and 98 per- cent. SuperBBS uses this to calculate the amount of time needed to download the file. Options......: Percentage -------------------------------------------------------------- SuperBBS v1.15 documentation Page 031 Command......: Download control string Description..: Format of each file entry in the control file specified above for downloads. One control code is available: %1 = Filename Normally this only contains %1. Please note that this option is not used if you selected the Bimodem protocol type. Options......: %1 Command......: Upload control string Description..: Format of each file entry in the control file specified above for uploads. One control char- acter is available: %1 = Filename Please note this option is not used when you selected a Bimodem protocol type. Options......: %1 Command......: Download logfile keyword Description..: Keyword which will be used in the logfile to note the download. Please note this option is only used if the logstyle type is set to Other. This option is not used when you selected the Bimodem protocol type. Options......: String Command......: Upload logfile keyword Description..: Same as for the download, except now for up- loads. The same exception rules apply. Options......: String Command......: File name word number Description..: Please note this option is only used when you select a logfile type as other. This option is not used in the Bimodem protocol type. Options......: Number With these options it is possible to setup 10 external proto- cols. The internal protocols can all be toggled on or off. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 032 Here is an example of a Bimodem v1.24 installation. Please note that not all options need to be set on the commandstring line with this protocol. Most settings can be configured in the Bimodem configuration file. Activated...........: Yes Name................: Bimodem Key.................: B Batch...............: Yes Protocol type.......: Bimodem Log style...........: Icom Download command....: c:\prot\bimodem.com /S%2 /T*T /D @c:\files.txt /F Upload command......: c:\prot\bimodem.com /S%2 /T*T /F Log file name.......: c:\bbs\icom.log Control file name...: c:\files.txt Effic...............: 96 Other options are left empty, because they are not used. Here's an example of an Puma setup: Activated...........: Yes Name................: Puma Key.................: P Batch...............: Yes Protocol type.......: Other Log style...........: DSZ Download command....: c:\prot\puma.exe S @c:\files.txt Upload command......: c:\prot\puma.exe R %1 Log file name.......: c:\bbs\dsz.log Control file name...: c:\files.txt Effic...............: 98 Download cntrl str..: %1 Upload cntrl str....: %1 Download log keyw...: Upload log keyw.....: File name word nr...: 0 This should help you get on your way. Refer to the SuperBBS echomail areas if you have trouble setting up a protocol. These areas can be found on most registered SuperBBS systems. The Bimodem protocol is only available with the normal down- load menu option. Other external protocols are available also at the download of the BBSList and Hot-key download command. You don't want your user's to start an upload while down- loading the BBSList file, do you? -------------------------------------------------------------- SuperBBS v1.15 documentation Page 033 2.5.5 Modem -------------------------------------------------------------- Here you must specify how your modem is setup if your not using a mailer. SuperBBS is capable of running without any front-end program, although you have to use a batchfile to run it. Please refer to the batchfile examples at the end of the documentation for more info on batchfiles. 2.5.5.1 Initialization -------------------------------------------------------------- Type.........: Initializing tries Description..: Number of times SuperBBS will try to initialize the modem. When the modem will not initialize, SuperBBS will give you a warning message and return to MS-Dos or the batchfile. Options......: Number Type.........: Initializing baudrate Description..: The fastest baudrate your modem supports. If you have a 2400 Bps modem, set this to 2400. You might have to lock the speed between your COM port and your modem at higher speeds and install a NS16550AFN chip, instead of the 16450 chip on your COMMS card. Options......: 300 to 38400 Type.........: Initializing string Description..: String send to the modem to reset the modem and prepare it to receive callers. Check your modem manual for the string used to setup your modem. The pipe symbol | can be used for a carriage return. (Some modems take a ^M as a CR.) Options......: Modem init string Type.........: Initializing response Description..: Answer the modem sends to the program, after the initialization string has been send to the modem. This response tells SuperBBS the modem is ready to receive calls. Options......: Modem response string -------------------------------------------------------------- SuperBBS v1.15 documentation Page 034 2.5.5.2 General options -------------------------------------------------------------- Type.........: Port Description..: Communication port the modem is connected to. This should be the port your modem is setup at, when you have an internal modem or the COM port the modem is connected to with an external modem. Options......: 1, 2, 3 or 4 Type.........: To wait for carrier Description..: Time SuperBBS waits for a carrier signal, before resetting. Options......: Seconds Type.........: Offhook string Description..: String send to the modem when you want to place the modem in 'offhook' mode. This means the callers will receive a busy signal. Please note that in some countries it is illegal to switch a modem offhook. Options......: Modem offhook string Type.........: Offhook response Description..: Answer the modem sends to the program, after the offhook string has been send to the modem. Options......: Modem offhook response string Type.........: xxxx BPS Connect (xxxx = 300 to 38400) Description..: Response from the modem after it has detected a caller and established a connection. This tells SuperBBS at what baudrate the user is calling. Check your modem manual for more information. Users of modems with MNP or V.42bis errorcor- rection protocols should use the normal connect strings for the reliable connections. Options......: Modem response 2.5.6 Other -------------------------------------------------------------- In this part of the configuration you will find some general options concerning New users, restrictions, Alt keys and others. 2.5.6.1 New users -------------------------------------------------------------- A caller who has never been on your system has to be assigned a special userlevel. This could be a normal level, which you are using for all users or, like most BBS systems do, a lower level, so you, the Sysop, can check his/her information. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 035 SuperBBS uses a double security system. All users, including the Sysop(s) have a security level. Besides that security level there are also 32 flags available. These flags can be toggled on or off. (X = On / - = Off) With these flags you could restrict people with a same userlevel from using the same options. Here is an example: User 1: User 2: Userlevel: 25 Userlevel: 100 Flag A: X------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: --XX---- Flag C: -------- Flag D: -------- Flag D: --XX---- Menu option A: Menu option B: Level needed: 25 Level needed: 25 Flag A: -------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: -------- Flag C: -------- Flag D: -------- Flag D: --XX---- Menu option C: Menu option D: Level needed: 10 Level needed: 100 Flag A: -------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: --XX---- Flag C: --XX---- Flag D: -------- Flag D: -------- User 1 would be able to use menu options A and C. The user has no access to menu option B or D, because in option B his flagsetting is not correct and in option D his userlevel is not high enough, although the flagsetting is correct. User 2 has access to menu option A and B. The user has no access to menu C because of the flagsetting, although his level is high enough, and the access to option D is denied because of the wrong flagsetting. You see how powerful this safety system can be. Use it with care, specially when you are setting up a BBS for the first time. Check your menu's with all available options, so you won't run in to a nasty surprise, like a user getting to a special Sysop menu. (SuperBBS also has the ability to protect menus with passwords. More of this in the menu commands.) Type.........: New user security level Description..: Level assigned to a new user when he/she enters the BBS for the first time. Options......: Userlevel Type.........: New user flags (A to D) Description..: Flagsetting assigned to a new user when enter- ing the BBS system for the first time. Options......: Flagsetting (X = On / - = Off) -------------------------------------------------------------- SuperBBS v1.15 documentation Page 036 Type.........: Ask voice phonenumber Description..: Toggle the voice phonenumber question on or off at logon for a new user. Options......: Yes/No Type.........: Ask data phonenumber Description..: Toggle the data phonenumber question on or off at logon for a new user. Type.........: Ask birthday Description..: Toggle the birthday question on or off at logon for a new user. Options......: Yes/No Type.........: Use aliases Description..: Toggle the use of aliases on or off for use in the bulletin board system. Options......: Yes/No Type.........: Ask sex Description..: Toggle the Male/Female question on or off at logon for a new user. Options......: Yes/No Type.........: ANSI graphics Description..: Toggle the ANSI graphics question on or off at logon for a new user. Options......: Ask/No Type.........: Mail check Description..: Toggle the mail check at logon question on or off at logon for a new user. Options......: Ask/No Type.........: New files check Description..: Toggle the new files check at logon question on or off at logon for a new user. Options......: Ask/No Type.........: Full screen editor Description..: Toggle the full screen editor question on or off at logon for a new user. Options......: Ask/No Type.........: Full screen viewer Description..: Toggle the full screen viewer question on or off at logon for a new user. Options......: Ask/No Type.........: More prompt Description..: Toggle the more prompt question on or off at logon for a new user. Options......: Ask/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 037 Type.........: Screen clears Description..: Toggle the screen clear question on or off at logon for a new user. Options......: Ask/No Type.........: Days until expiration Description..: Number of days added to the expiration counter for the new user. This way you could automati- cally add a certain number of days to the record of the new user. SuperBBS will decrease this field every day with one, until it is zero. Than the questionnaire EXPIRED.Q-A is activated when the user logs on. Options......: Number of days 2.5.6.2 General options -------------------------------------------------------------- The general options in SuperBBS contain information about how SuperBBS reacts to certain things, like inactivity time outs, logons with wrong passwords and a whole range of other options. Type.........: Inactivity time (Seconds) Description..: Time in seconds before SuperBBS will disconnect a user if no key is pressed in the specified time period. This option prevents users from keeping the system busy, while they are doing something else. SuperBBS will display a warning 20 seconds before disconnecting. Options......: Time in seconds Type.........: Maximum logon times (Minutes) Description..: Time limit given to new users to logon to your system. Depending on the size of your question- naire, you should set this to a safe amount, otherwise your user will be logged off when in the middle of answering the questions. Options......: Time in minutes Type.........: Menu border colour (0-7) Description..: Colour of all the menu borders hardcoded into SuperBBS. Available colours are: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey -------------------------------------------------------------- SuperBBS v1.15 documentation Page 038 The colour blue (1) will be displayed as an underlining on monochrome Hercules monitors. This could cause you menus to look weird, so don't use blue if you don't need it. Options......: Colour number Type.........: Entry field colour (0-7) Description..: Colour of the background when SuperBBS asks the user for input. (For available colours see the menu border option.) Please use this option with care. On VGA monitors some colour combina- tions are not as visible as they could be. (For example yellow text on a green background.) Options......: Colour number Type.........: Maximum password tries Description..: Maximum number of times the user can try to get the right password to logon to the BBS, before being forced off-line. If enabled, SuperBBS will ask the user if he/she wants to leave a message to the Sysop. Don't set this number to high. Options......: Number of attempts Please note that SuperBBS will not ask for a password if there is no password supplied in the userfile. This can only be achieved through the use of the Sbbsuser.exe program. (When an user logs on to your system, he/she has to provide a password of at least 4 characters.) You could use this option to pro- vide 'guest' access to your system. Use this option with care! Type.........: Maximum pages per call Description..: Maximum number of times the user can yell for the Sysop per call. If the user tries another time, a message will be displayed. Options......: Number of pages Type.........: Page bell length (Seconds) Description..: Number of seconds the page melody will be played when the user tries to page the Sysop. This will only be heard at the Sysop machine. If you don't use Yellcfg.exe, this will be a 'fiuus' siren like sound. Options......: Time in seconds Type.........: Sysop security level Description..: Security level used by the System Operator of the BBS, mostly you! Options......: Security level -------------------------------------------------------------- SuperBBS v1.15 documentation Page 039 Type.........: Entry colour (0-15) Description..: Type of colour used to display the users answers in the entry fields. The entry fields will have the background colour supplied at the entry field colour option above. Do not use 0, as this would be black and the user could not read his/her answer. Available colours: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey 8. Dark grey 9. Light blue 10. Light green 11. Light cyan 12. Light red 13. Light purple 14. Yellow 15. White Remember that blue gives an underlining on monochrome Hercules monitors. Options......: Colour number Type.........: Maximum minutes in bank Description..: Maximum amount of time in minutes a user can store in the build in time bank. Options......: Number of minutes Type.........: Redirect device Description..: Device which will be used to redirect communi- cation when using, for example, the Tempdir option. The 'Gateway' driver, which is to be found on most BBS's, is perfect for this. If you don't have a gateway driver, use COMn. (n = your COM port number) The redirection will make sure that everything displayed on your local screen is also visible on the remote screen and that the remote keyboard will work as an input device. The Gateway driver will allow you the use of both the local and remote monitor and keyboard. Options......: COMn or Gateway driver -------------------------------------------------------------- SuperBBS v1.15 documentation Page 040 Type.........: First menu in system Description..: Normally you start your system with the TOP.MNU menu. If you want your system to start with an other menu, instead of the TOP.MNU menu, you can enter the name here. SuperBBS will then start at the given menu. If left empty, Super- BBS will start at the TOP.MNU menu. Please note that the load menu option in the SBBSUSER.EXE program overrides this option. Options......: Menu name Type.........: ANSI at logon Description..: If you have ANSI menu's and screens available, SuperBBS can ask at logon to display the ANSI version of the logon sequence, instead of the ASCII sequence. Also available at this option is the detection of ANSI. SuperBBS will know if the user is using ANSI or not. If not, SuperBBS will display the ASCII logon, otherwise the ANSI logon is displayed. With this option it is possible to have ANSI off and still use the full-screen editor. (Which normally only works if the user has ANSI enabled.) If the user has the FS editor switched on, ANSI switched off and he/she wants to write a message, SuperBBS will use the FS editor if it detected the user has ANSI available. This will only work if you have switched this option to 'Detect'. Options......: Yes/No/Detect Type.........: Phonenumber scanning mode Description..: SuperBBS can compare a newly entered phone number with the already available phonenumbers of the other users and respond to duplicate numbers. You have three options here: - No scanning - Scan and system.log entry - Scan, system.log entry and disconnect SuperBBS will not check for double phonenumbers if you set this function off. If only the sys- tem.log entry is enabled, SuperBBS will write an entry in the logfile telling you the user used an already available phonenumber. The third option does the same, but goes one step further. SuperBBS will display the ANSI/ASCII file DPHONE.A?? and then disconnect the user. Options......: No scan/System.log/Disconnect -------------------------------------------------------------- SuperBBS v1.15 documentation Page 041 2.5.6.3 On/Off settings -------------------------------------------------------------- Type.........: Output ^E character Description..: The ^E or ENQ character is used by some com- munications programs to determine the begin of a session. For example Telix's Salt language can react to it. Options......: Yes/No Type.........: Use direct screen writes Description..: Allows SuperBBS to write directly (=fast) to the screen, instead of using the BIOS routines. Some CGA monitors with 'snow' need this option off. Also some multitaskers prefer BIOS screen writes. Options......: Yes/No Type.........: Snow checking Description..: Allows you to check for 'snow' on your monitor. This normally only the case with old CGA moni- tors. Options......: Yes/No Type.........: Show security in userlist Description..: Option to display the security levels when a user views the username list. Options......: Yes/No Type.........: Logon password to Sysop Description..: If enabled, this option will show the password from the user loging on to your system at the bottom of the local screen to the Sysop. This will only be visible at the Sysop side. Options......: Yes/No Type.........: Use 7bit characters Description..: If enabled, this option allows only the use of 7bit characters in the echomail areas. Options......: Yes/No Type.........: Run system in mono mode Description..: If you're using a monochrome monitor on your system, you could set this option to 'Yes'. This only affects your side of the system, users will see all available colours when run- ning ANSI graphics. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 042 Type.........: Logout temp dir clean Description..: This option enables SuperBBS to clean the tem- porary directory after the user logged off. This will prevent files being left in the tem- porary directory. Options......: Yes/No Type.........: Allow one word names Description..: If this option is enabled, users will only have to give one name to logon to the system. It will allow more than one name, but SuperBBS will only scan for the first part of the name. If not enabled, the user will be asked his first and last name. Names with more than 2 parts, should be separated by a period. For example: John.mike Mac.arthur Options......: Yes/No Type.........: Sysop fast logon Description..: This option allows you, the Sysop, to logon to the BBS quickly by only giving a password. SuperBBS will presume the Sysop is the user on- line. Don't use this option if you have more than one person login on to your system locally. Options......: Yes/No Type.........: Exclude Sysop Description..: If you don't want your (Sysop)name to be dis- played in the lists SuperBBS generates, like last 15 callers and userlist, switch this off. Options......: Yes/No Type.........: Alt-J swapping Description..: SuperBBS has the option to swap itself to EMS memory or disk when you jump to Dos. (Alt-J). This will leave only 4 Kbyte of SuperBBS in the memory resident, allowing to run some other program while shelled to dos. Options......: Yes/No Type.........: Capitalize city Description..: SuperBBS can capitalize the information in the City field. The first character will be upper case, the others will be lower case. Example: helsinki ----> Helsinki WOERDEN ----> Woerden New York, USA ----> New York, Usa Note that USA or any other abbreviation will also be capitalized. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 043 Type.........: Capitalize alias Description..: See capitalize city, except this time it works on the alias field of the userrecord. Options......: Yes/No Type.........: Crtl-X in pictures Description..: SuperBBS allows you to run external programs from a textfiles. You will have to set the commandline in the file as follows: <Ctrl-X>Myprog.exe *F *L| When a user displays the textfile, SuperBBS will notice the Ctrl-X and executes the program behind it. The pipe symbol means ENTER. If you don't use Ctrl-X codes, leave this option dis- abled. Options......: Yes/No Type.........: Alias search at logon Description..: It is now possible to logon with your alias name if the Sysop enables this option. You will still be asked for a password. Options......: Yes/No Type.........: US Phonenumber format Description..: For those who are working with the American phone format, SuperBBS now allows you to use the (XXX)XXX-XXXX format for your phonenumbers. If your not using the USA format, leave this option off. Note that always the full voice and data phone numbers are required when using the US phone format. Options......: Yes/No Type.........: Allow IEMSI logins Description..: SuperBBS allows automatic logins to your system through the use of IEMSI. IEMSI is a standard set in the FSC-56 (or EMSC-001) proposals. Some programs, like Frontdoor Terminal, support this concept. It allows you to specify your profile, like name, password, ANSI, CLS, More, New files, Message scan and other options. When calling a BBS system which has IEMSI available, the login will be done automatically. No script file is needed. If the BBS uses Frontdoor as a mailer, the 'Press 2x ESC' bit is also done by IEMSI. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.15 documentation Page 044 Type.........: Random birthday verify Description..: To obtain a better system security, SuperBBS allows you to switch on a birthday verification option. If enabled, SuperBBS will at every login, even the local ones, take a random num- ber between 1 and 5. If this number is 1, the user will be asked for his/her birthday. If entered correctly the user can go on, if not correct, the user will be disconnected. The ANSI/ASCII file BVERIFY.A?? is displayed before the verification. Options......: Yes/No Type.........: Create DORINFO?.DEF Description..: SuperBBS can now create a DORINFO?.DEF file for every node. Instead of the normal DORINFO1.DEF file, the DORINFO?.DEF file will have the node- number in place of the '?' sign. Like for node 4 it would be DORINFO4.DEF. Options......: Yes/No Type.........: No extended node info Description..: SuperBBS can now display in the online menutype that a node is 'Down' or 'Waiting for call'. You have to change this with SBBSUTIL.EXE in your batchfile. This option allows you to turn that info on or off. Options......: Yes/No Type.........: No Local Attach (LA) check at logon Description..: Tells SuperBBS to scan for local attach files at logon or not to scan for them. Options......: Yes/No 2.5.6.4 Restrictions -------------------------------------------------------------- Here you specify the Bps rates needed to logon to the system, time of the day downloading and paging the Sysop is permitted and 300 Bps usage. Type.........: Min. Bps rate to logon Description..: This will prevent users with a Bps rate lower than the one specified to gain access to your system. Options......: Bps rate Type.........: Min. Bps rate to allow ANSI Description..: Minimum Bps rate a user must have, before he/she can use the ANSI menus and textfiles. Options......: Bps rate -------------------------------------------------------------- SuperBBS v1.15 documentation Page 045 Type.........: Min. Bps rate to file transfers Description..: Minimum Bps rate a user must have before he/she can transfer files. Options......: Bps rate Type.........: Min. Bps rate for Full Screen chat Description..: Minimum Bps rate of a user to be able to use the full screen chat. Options......: Bps rate Type.........: 300 Baud usage time window Description..: SuperBBS allows you to keep 300 Bps users from your system at certain hours. A message will be displayed if the user is too slow for the BBS. Options......: Start and end time (24 hour format) Type.........: Downloading time window Description..: Time period in which file transfers are allowed. A message will be displayed if a user tries to do a file transfer outside these hours. Options......: Start and end time (24 hour format) Type.........: Min. security to logon Description..: If the user has a lower security level than specified here, he/she will be logged off after the file LOGONSEC.A?? is displayed. This way you could run a second line for known users only or just allow members on the BBS. If left blank this option is disabled. Options......: Security level or None Type.........: Min. age to logon Description..: If the users age is lower than the age set in this option, the user will be logged off after SuperBBS displayed the LOGONAGE.A?? screen to the user. If left blank this option is dis- abled. Options......: User age or None Type.........: Password to logon Description..: The user is asked for the password given in this option if he/she wants to logon to the system. If the user enters a wrong password SuperBBS will display the file LOGONPWD.A?? and then disconnects the user. If left blank, this option is disabled. Note that the password given here is a 'global' password. the user still has to enter his/her own password to get into the system. Options......: Password or None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 046 Type.........: Sysop paging time Sunday (to Saturday) Description..: Time period in which it is possible to page the Sysop. If a user pages outside these hours, a message will be displayed. You can set the paging hours for every day of the week. Options......: Start and end time (24 hour format) 2.5.6.5 Alt-F keys -------------------------------------------------------------- From within the SuperBBS program, you have access to 10 programmable keys, Alt-F1 to Alt-F10, for your own programs. These keys are only available to the local system, a remote user can not access the Alt FKeys. An example: Alt-F1: C:\SUPERBBS\SBBSUSER.EXE *S The *S tells SuperBBS to swap itself out to EMS or disk, before executing the requested program. All ten keys are available for your own use. 2.5.6.6 String configuration -------------------------------------------------------------- This part of the configuration program allows you to define some of the strings used in the SuperBBS program. These strings will be shown to your users if needed. Please note that these strings are used for all languages and every user. Make sure everybody can understand them. More strings of SuperBBS can be configured through the use of the Lconfig program described later. The Lconfig program will allow you to run a multi lingual system. Type.........: Loading prompt Description..: Shown to your users at a type 7 or 15 exit from SuperBBS, when executing an external program. (See the menu part of the docs for more infor- mation about those menu options.) Options......: String Type.........: Selection menu prompt Description..: Shown to your users after displaying the index file from a selection menu. This prompt should include the following options: [ENTER] To return from the selection menu to the main BBS. [1...9] Options available. This depends on the amount of options avail- able in the selection menu. Cur- rently 9 is the maximum. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 047 The L for list is not needed, because SuperBBS will automatically display the index file after a user has viewed an available selection. For more information about the selection menu, check out the menu part of the documentation. Options......: String Type.........: Origin line Description..: This string will be added to every echomail message send from your system. The maximum length for this string is 80 characters, in- cluding your address defined in the netmail part of the config program and '* Origin: ' which is put in front of your origin line by SuperBBS. You are not allowed to use extended ASCII or ANSI codes in this line. It is useful to include your phone number so people know how to find you when reading messages originating from your board. Options......: String Type.........: F8 status line 1 Description..: SuperBBS shows the Sysop a lot of information on the two bottom lines of the screen while a user is online. Now you can define the text displayed for the F8 function key. You can use all available control codes in the line. Please note that the line cannot exceed the 80 charac- ters including the (expanded) control charac- ters. Options......: Status line Type.........: F8 status line 2 Description..: SuperBBS shows the Sysop a lot of information on the two bottom lines of the screen while a user is online. Now you can define the text displayed for the F8 function key. You can use all available control codes in the line. Please note that the line cannot exceed the 80 charac- ters including the (expanded) control charac- ters. Options......: Status line 2.5.6.7 Door configuration -------------------------------------------------------------- SuperBBS is the first BBS program to support menu templating for doors. This means you can use one menu for all your doors. You can configure up to 200 different doors. Instead of setting up all doors separately in your menus, you now use control codes, which are replaced by the information given in the configuration menu of the doors. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 048 The following options are available in this part of the con- figuration program: [PgDn] Move to next area [PgUp] Move to previous area [F1] Add door [F2] Delete door [F3] Jump to door Pressing [ESC] will get you back to the main configuration menu and save the door information. You will have to provide the following information: Type.........: Door name Description..: Name of the doorgame. This will be displayed in the door select menu and by using the control codes. Options......: Menu name Type.........: Command line Description..: The commandline to start the door. here you can use all options available to type 7 exits. (See menu types for more information.) If you want to use a type 15 exit, you will have to use a '?' as the first character on the commandline, followed by the errorlevel. Example: ?115. This will exit to your batchfile with errorlevel 115. (An example will follow below.) Options......: Commandline or Errorlevel (?xxx) Type.........: Security level Description..: Security level needed to access the door. With- out the correct security level the door won't be displayed in the list of available doors. Options......: Security level Type.........: Flags A to D Description..: Flagsetting needed to access the door. Without the correct flagsetting the door won't be dis- played in the list of available doors. Options......: Flagsetting (X = On/- = Off) Type.........: Start time Description..: Starting time for the door to be available to the users. This has to be in 24 hour format. Options......: Time (24 hour format) -------------------------------------------------------------- SuperBBS v1.15 documentation Page 049 Type.........: End time Description..: Ending time of the availability if the door. With the starting time you can have opening and closing hours on your doors. Options......: Time (24 hour format) Type.........: Active Description..: If this option is turned off, the door will never show up in the doorlist. If enabled the door is accessible for the users (if the time settings allow it). Options......: Yes/No Here's an example of how to setup a door. Used here is the Pong doorgame from Livesystems (TM): Name: Pong Commandline: \doors\pong.exe -T:*T -NOS -BALLS:4 Security: 10 Flag A: ---X---- Flag B: -------- Flag C: -------- Flag D: -------X Start time: 10:00 End time: 22:00 Active: Yes This setting will only allow users in the door with a security level of 10, flags A4 and D8 set to On. And the user has to call between 10:00 (10 am) and 22:00 (10 pm) hours. Menu commands 86 and 87 are used for accessing the doors. See the menu part of the configuration for more information. Two new control codes have been added to display the doorname and number. These are: <Ctrl-K>& Name of the current door <Ctrl-K>/ Number of the current door A new control code is used to specify the current door in the optional data field. This code is: @D Number of the door You can use this code to display a different file for every door, by using it in the optional data field like this: Menu type: 5 Optional data: DOOR@D If you are at door number 3, the file DOOR3.A?? will be dis- played. If your at door number 198, file DOOR198.A?? will be displayed. This is one example of how to use the control code. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 050 2.5.6.8 Multi node configuration -------------------------------------------------------------- The multiline options are available for running a multiline system. SuperBBS is designed to run multiline. You have to fill in the following options, even if you run a single line system. Type.........: Lines in system Description..: Number of lines you are running. If you run a single line system, enter 1. Otherwise enter the number of lines, including local lines. Make sure you set this to the same amount for every line. Options......: Number of lines Type.........: Common path Description..: Drive and directory which will be used by all lines available as a common directory. A RAM disk of 30 to 50 Kbytes is recommended. A nor- mal disc can also be used if a RAM disc is not available. SuperBBS will store information like who is online in this directory. Options......: Drive:\Pathname 2.5.6.9 Event editor -------------------------------------------------------------- SuperBBS allows you to setup 30 events, which will be executed at the set time and weekday(s). This allows you to run main- tenance, clean up actions and other activities at quiet moments. You have to setup SuperBBS with a batchfile and errorlevels if you want to use this option. Otherwise SuperBBS will exit at the given time and weekday, but will never return. Moving around the fields with the cursor keys. [PgUp] and [PgDn] will switch between the events. [F1] will jump to a certain asked for event number. Type.........: Status (O = Deleted/1 = Enabled) Description..: Controls wether the event is active or not. The 1 means active, the 0 means inactive. Options......: 0 or 1 Type.........: Runtime Description..: Time the event has to be executed in 24 hours format. Options......: Time -------------------------------------------------------------- SuperBBS v1.15 documentation Page 051 Type.........: Errorlevel Description..: Errorlevel SuperBBS exits with at the time of the event. This allows you to start an external program from your batchfile. Do not use error- levels between 0 and 10, because these have special meanings for SuperBBS. Consult your DOS manual if you are unfamiliar with the use of errorlevels. Errorlevels may range from 0 to 255. Options......: Errorlevel Type.........: Forced Description..: If an event is scheduled, but a user is on-line at the given time, the event will be overdue and not be executed. When you force an event to be executed, SuperBBS will reduce the time of the caller online, so he/she is logged of just before the event starts. A warning message will be displayed to the user, telling him/her the time is adjusted. SuperBBS will not allow callers online within five minutes before the event. Options......: Yes/No Type.........: Days to run the event Description..: This tells SuperBBS on what day(s) the event has to be executed. (Sunday to Saturday). mark the days you want to run the event with 'X'. Options......: X 2.5.7 Colours -------------------------------------------------------------- This part of the configuration allows you to change the col- ours used within SuperBBS. (There are two pages available.) Your users will be able to change them personally, but this option allows you to set the 'Standard' colours. You will be presented with a view of the current colours. Press the number corresponding with the number you want to change and use the cursor control keys to change the colour. The following keys are active in these menus: [ESC] Exits to main menu. [D] Sets colours to default values. [0-9] Available options keys. [Cursor] Change colour. The user can set the colours to his/her own liking with the available menu option. These settings are however your 'standard' settings for all users. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 052 The following to pages are available: Page 1: 1. Message header and date 2. From field 3. To field 4. Subject field 5. Text field 6. Option line below message 7. File name in file list 8. File size 9. File date 0. File description Page 2: 1. Numbers in area choose list 2. Name in area choose list 3. Choose area command 4. Press ENTER command 5. Sysop colour in FS chat 6. Users colour in FS chat 7. Status line foreground 8. Status line background Note that option 1, 2 and 3 on page 2 are for the door select command and the message and file area select command. The following colours are available: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey 8. Dark grey 9. Light blue 10. Light green 11. Light cyan 12. Light red 13. Light purple 14. Yellow 15. White Please note that the colour blue will be represented on mono- chrome HGC systems as a highlighted underlined colour. This can give strange effects on these screen when viewing your menus. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 053 2.5.8 Limits -------------------------------------------------------------- The LIMITS.BBS file contains all information about security levels and flagsettings for all users.This file is the control centre for the time allowed online, download limits, ratio checks and call allowed per day. This file is not an ASCII file and can only be edited through the configuration program. Security levels can range from 0 to 32000, where 0 is the lowest available level and 32000 the highest. Take a little time to think about how many levels you will need and if you need any flagsettings.The flagsettings are an easy way to give somebody access to an area, while others with the same or higher level don't have access to. Remember that even the Sysop has no access if his/her flagsettings are not right. If you enter the Limits editor, you'll be presented with a small window. Here you can add, delete and change the user- levels. The following keys are active: [ENTER] Choose the marked level for editing. [INSERT] Add a new user level. [DELETE] Remove a userlevel. [F1] Converts LIMITS.CTL to LIMITS.BBS. [ESC] Return to main configuration menu. [CURSOR] Move around the available levels. When choosing a level, you will be presented with a second window, where you can edit the options. SuperBBS will sort the userlevels from small to big in the main window, so don't worry if you want to insert a level somewhere. Type.........: Security level Description..: Current security level. this can not be edited in the edit window. Only in the main window can you add or delete security levels. Options......: None Type.........: Download limits per Bps rate Description..: Number of Kbytes a user can download per day. The values depend on the speed. If a user exceeds this limits, he/she will see a warning. Options......: Amount in Kbytes -------------------------------------------------------------- SuperBBS v1.15 documentation Page 054 Type.........: Time limit (in minutes) Description..: Maximum time allowed per day. The user will see a message if his/her time is used up for the day. He/she has to wait till the next day, before he/she is granted access again. Option.......: Time in minutes Type.........: Calls allowed per day Description..: Besides the time limit, you can also setup a limit of calls per day. If a user calls more than the set amount, he/she will see a message and will be disconnected. Option.......: Number of calls Type.........: Download/Upload ratio in Kbytes Description..: The users download/upload ratio in Kbytes. This means that if a caller downloaded xx Kbytes, he/she has to upload yy Kbytes before another download can be performed. Setting this to 0 disables the option. Options......: Kbytes Type.........: Download/Upload ratio in files Description..: The users download/upload ratio in files. this means that a user who downloaded xx files has to upload a file, before he/she can download again. If you set this to 5, every user has to upload 1 file to download 5. Setting this to 0 disables the option. Options......: Number of files Type.........: Description Description..: Description for the current user level. This can be used in your textfiles through the use of a control code. You can display the descrip- tion to the user by using a control code. Please note that this description is the same for all languages. Options......: Name Pressing [ESC] will bring you back to the main Limits window and save the changes. Pressing [ESC] again will bring you back to the main configuration menu. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 055 2.5.9 Paths -------------------------------------------------------------- This part is important. Making mistakes here could cause SuperBBS not to run. Make sure all paths are correct. A back- lash at the end of a directory path is optional. Type.........: Text path Description..: Drive and directory where your supporting ASCII and ANSI textfiles will be stored. In the LCONFIG.EXE program are the path statements also included. If SuperBBS can't find the wanted file in the directory stated in the language file, it will look in the directory specified here. Options......: Drive:\Pathname Type.........: Menu path Description..: Drive and directory where your menu files are stored. In the language file you also have to specify the directory for the menu files. If SuperBBS can't find the wanted menu file in the directory stated in the language file, it will look in the directory specified here. Options......: Drive:\Pathname Type.........: Net path Description..: Drive and directory where your netmail is stored. Some mailer systems can handle *.MSG netmail messages and they need this directory. If you use D'Bridge (TM) and SuperBBS with the netmail area setup as a QuickBBS (TM) type mail area, you have to point this directory to an existing directory, although the option is not used with this configuration. Options......: Drive:\Pathname Type.........: Message base path Description..: Drive and directory where your message base files (MSG*.BBS) are stored. This can be the main SuperBBS directory, or another directory. Point this to the same directory for every line you run in a multinode system. Please note that some echomail processors require the message base files in the main BBS directory. All the MSG*.BBS files will be created the first time you run SuperBBS. Options......: Drive:\Pathname -------------------------------------------------------------- SuperBBS v1.15 documentation Page 056 Type.........: Temporary path Description..: Drive and directory where SuperBBS will place temporary files, created when using the archive extract, view and repack option. A multi-node system will need a directory for every node. Options......: Drive:\Pathname Type.........: System path Description..: Drive and directory where your main BBS files will be placed. This is the directory you run the configuration program from. Here all system files will be placed. Options......: Drive:\Pathname Type.........: Work path Description..: Drive and directory where SuperBBS will place files it has to work with. Files uploaded to your BBS can be checked for viruses in this directory. Create a directory for every node you are running. Options......: Drive:\Pathname Type.........: External editor Description..: Drive, directory and filename of the external editor you want to use in the BBS. The most used editor is Quicked. Leave this page blank if you don't have a full-screen editor. Super- BBS now writes DORINFO?.DEF and EXITINFO.BBS before shelling to the editor. This allows you to use the *S command, to tell SuperBBS to shell to EMS/DISK before calling the editor. Option.......: Drive:\Pathname\Filename.ext Type.........: Virus scanner Description..: The viruschecking program is now configurable. You can use four optional parameters in the virusscanner commandline. These are: %1 Is replaced by the complete filename to scan. Example: C:\WORK1\SBBS_115.ZIP %2 Is replaced by the filename without the directory. Example: SBBS_115.ZIP %3 Is replaced by the extension only. Example: .ZIP %4 Is replaced by the directory only. Example: C:\WORK1\ All menu type 7 parameters (see menu types for these parameters) are available for your use. If this line is left empt, SuperBBS will use McAfee's Scan (TM) for scanning viruses. You can also specify if the file has to be -------------------------------------------------------------- SuperBBS v1.15 documentation Page 057 extracted before the virusscan and with what errorlevel to exit when a virus is found. (These are set in other parts of the configur- ation program.) Option.......: None or virusscanner and options Type.........: Nodelist path Description..: SuperBBS has (limited) nodelist support. You will need to specify where your nodelist is located. This nodelist has to be compiled with the external SuperBBS program SBBSNODE.EXE. (See external programs for more information on this utility.) SuperBBS uses the real Nodelist and can use up to 10 private nodelists. Nodelist support is limited, because the costs field is not supported yet. This will change in a future release. SuperBBS also supports Point numbers now in netmail addresses. SuperBBS will also work without the nodelist files without any problem. Point addresses are still sup- ported. Options......: Path to Nodelist and index files Type.........: Local Attach (LA) path Description..: Your users can now send files to each other. Local Attach files is achieved through menu option 90. the files are stored in the direc- tory specified here. See the chapter on files for more information. Options......: LA directory 2.5.10 Quit -------------------------------------------------------------- This option exits you from the configuration program. Pressing ESCape from the configuration menu has the same effect. You will be asked if you want to save the configuration file or not. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 058 2.6 Environment variable -------------------------------------------------------------- As of version 1.10, SuperBBS needs an environment variable SBBS. This variable needs to be set before starting SuperBBS. Your AUTOEXEC.BAT or SuperBBS batchfile is a good place for it. Setting the variable works like this: SET SBBS=Drive:\Pathname The drive and directory should point to your main SuperBBS directory, where the BBS.EXE file is stored. If you don't know how to make an AUTOEXEC.BAT file, consult your DOS manual. If you get an error like: 'Out of environment space', you will have to enlarge the environment size in your CONFIG.SYS file. See your DOS manual for more information. Setting this variable is needed for single and multi line. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 059 Chapter 3. Language support ============================================================== 3.1 General information -------------------------------------------------------------- SuperBBS supports the use of many different language files, so you can setup menus and supporting textfiles in your own language or several different ones. The language support is done through the use of the .LNG files. These files are edited with the LCONFIG.EXE program. You can setup different menu and textfiles directories for every language file in use. This way you are able to have all files and menus in the languages you choose to use. Let's have a look at an example: English: Menu path: c:\sbbs\menu-uk Text path: c:\sbbs\text-uk Dutch: Menu path: c:\sbbs\menu-nl Text path: c:\sbbs\text-nl If a user chooses the dutch language file, SuperBBS will look in the directory specified in the dutch .LNG file, i.e. c:\sbbs\text-nl and c:\sbbs\menu-nl for the text and menu files. All systemfiles are in the directory defined in the main configuration program, described in chapter 2. Even if you are using 1 language file, you still have to tell SuperBBS where to look for it's files. The description is shown to users who login for the first time, or want to change their language used. If SuperBBS can't find the specified file in the directory given in the .LNG files, it will look in the directory spec- ified with the SBBS variable. This way you don't need separate language files for every line you run. 3.2 Lconfig.exe -------------------------------------------------------------- You can start the language configuration program in two ways. The normal way is to start the program without any parameters, but you can also enter the filename of the file you want to edit as a parameter. For example: LCONFIG.EXE <Xmit> or LCONGIF.EXE ENGLISH.LNG <Xmit> The second option will load the language file ENGLISH.LNG at startup. The first option will ask you for the file you want to edit and display the directory. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 060 When you start the LCONFIG program, you will be presented with the following menu: 0. Path & description B. Other strings (Page 3) 1. Logon strings (Page 1) C. Status strings 2. Logon strings (Page 2) D. Month strings 3. MsgBase strings (Page 1) E. Weekday names 4. MsgBase strings (Page 2) F. BBSList strings 5. MsgBase strings (Page 3) G. Multi line status str. 6. Msg reading command keys H. QWK strings 7. FileBase strings (Page 1) ?. A little help 8. FileBase strings (Page 2) 9. Other strings (Page 1) A. Other strings (Page 2) Description : Menu path : Text path : Date format : Input date format : Time format : <ESC> to exit Moving around the configuration program is done through the cursor keys. Pressing [ESC] will save the changes and exits the program or, when editing a page, return you to the main configuration menu. Take note of the fact if their is a question mark behind the question or not. Some questions will have a (Y/n)? or (N/y)? option automatically put behind it. 3.2.1 Path & description -------------------------------------------------------------- Here you specify where the language menu and textfiles are stored. Also it is now possible to change the way SuperBBS uses the date and time. You can adjust the time and date the way they are used in your own country or even different for each language you use. Type.........: Description Description..: Name given to the language file. Displayed to new users at logon and users who want to change their language. Example......: English -------------------------------------------------------------- SuperBBS v1.15 documentation Page 061 Type.........: Menu path Description..: Directory where SuperBBS will look for the menu files belonging to this language file. You can have more than one language file pointing to the same menu directory. The backlash at the end is optional. Example......: c:\superbbs\menu-uk Type.........: Text path Description..: Directory where SuperBBS will look for the text files belonging to this language file. You can have more than one language file pointing to the same directory. The backlash is optional. Example......: c:\superbbs\text-uk Type.........: Date format Description..: Specifies the way SuperBBS uses the date in it's fields. Here are some examples: dd-mmm-yy becomes : 31-Jan-91 mm-dd-yy 01-31-91 dd-MM-yy 31-1-91 If the settings are in capitals, the 0 will be replaced with a space. Example......: dd-mm-yy Type.........: Input date format Description..: Specifies the way SuperBBS uses the date in it's input fields. Please note the difference with the previous option. This one is only for input fields. You can't use the dd-mmm-yy for- mat in this field. Note that when you change this field, you should also change the string asking for the birthday and any other date, like new files check. Example......: mm-dd-yy Type.........: Time format Description..: Specifies the way SuperBBS uses it time format. Here's an example: hh:mm te becomes: 03:03 pm hh:mm 15:03 If characters are in capitals, the 0 will be replaced by a space. Example......: hh:mm -------------------------------------------------------------- SuperBBS v1.15 documentation Page 062 3.2.2 Logon strings (Page 1) -------------------------------------------------------------- These are strings shown to the user when entering the system. Type.........: ANSI logon question Description..: Asked at the moment SuperBBS detects a carrier. Only works when the option in the main con- figuration program is activated. Example......: Display ANSI login Type.........: Name question Description..: Shown to user when SuperBBS asks for the users name at logon. Example......: Enter your first and last name : Type.........: Name entered string Description..: Shown to the user if his/her name was not found in the userlist and SuperBBS asks if the name is correct. Example......: Name entered : Type.........: Correct question Description..: Shown when SuperBBS asks if the name is cor- rectly written. Example......: Is this correct Type.........: Alias question Description..: Shown when SuperBBS asks for an alias. Example......: Choose your alias to use : Type.........: Use alias question Description..: Shown to the user when he/she pressed [Enter] at the alias question. Example......: Do you want to use an alias Type.........: City question Description..: Shown to the new user when SuperBBS asks for the city and state the user is from. Example......: Where are you calling from (City & State) ? Type.........: ANSI question Description..: Shown to the new user when SuperBBS asks the user if he/she wants ANSI graphics. Example......: Would you like ANSI colour graphics Type.........: Mailcheck question Description..: Shown to the new user when SuperBBS asks if the user wants a mail check at every logon. Example......: Would you like a mailcheck at every logon -------------------------------------------------------------- SuperBBS v1.15 documentation Page 063 Type.........: Newfiles question Description..: Shown to new users when SuperBBS asks if the user wants a new files check at every logon. Example......: Would you like a new files check at every logon Type.........: Editor question Description..: Shown to the new user when SuperBBS asks if the user wants to use the fullscreen editor. This question is only asked if the user answered 'YES' to the ANSI question. Example......: Do you like to use the full-screen editor Type.........: Screen length question Description..: Shown to the new user when SuperBBS asks the user what screenlength he/she want. this defaults to 24 lines per page. Example......: How many lines per screen page (12 - 60) ? Type.........: Birthday question Description..: Shown to the new user when SuperBBS asks for the users birthday. Example......: Your birthday (DD.MM.YY) ? Type.........: More question Description..: Shown to the new user when SuperBBS asks the user if he/she wants the 'More (Y/n)?' prompt or not. Example......: Would you like to pause after each page Type.........: Screen clears question Description..: Shown to the new user when SuperBBS asks the user if he/she wants the screen to be cleared if the CLS code is send. Example......: Do you want the screen to be cleared Type.........: Home phone number Description..: Shown to the new user when SuperBBS asks the user for his/her voice telephone number. Example......: Please enter your VOICE phone number : Type.........: Data phone number Description..: Shown to the new user when SuperBBS asks the user for his/her data telephone number. Example......: Please enter your DATA phone number : Type.........: Scanning dupe # Description..: Shown to the user when SuperBBS is scanning the userbase for duplicate phonenumbers. Example......: Scanning for duplicate numbers. Please wait ... -------------------------------------------------------------- SuperBBS v1.15 documentation Page 064 3.2.3 Logon strings (Page 2) -------------------------------------------------------------- Type.........: New password question Description..: Shown to the user when SuperBBS asks the user for the password the user wants to use on the BBS. Example......: Enter the password to use : Type.........: Password check question Description..: Shown to the user when SuperBBS asks the user for the password to be re-entered. Example......: Re-enter your password : Type.........: All OK question Description..: Shown to the user when SuperBBS asks the user if he/she entered all questions correctly. Example......: Did you enter all information correctly Type.........: Password question Description..: Shown to the user when he/she has to enter the password to gain access to the BBS. Example......: Password : Type.........: Mail check message 1 Description..: Shown to the user when SuperBBS is scanning for mail for the user. Example......: Checking for new mail addressed to you.... Type.........: Mail check message 2 Description..: Show to the user when no messages are found for the user. Example......: Sorry, no new messages found Type.........: Mail check message 3 Description..: Shown to the user when messages are found for the user. Example......: Read messages now Type.........: Password failure message Description..: Shown to the user when he/she entered a wrong password for three times and SuperBBS asks if he/she wants to leave a message. Example......: Do you want to leave a message for the Sysop Type.........: Full screen reader Description..: Shown to the new user when SuperBBS asks the user if he/she wants to use the full-screen reader. Example......: Do you want to use the full screen reader -------------------------------------------------------------- SuperBBS v1.15 documentation Page 065 Type.........: Sex question Description..: Shown to the user when SuperBBS asks if the user is a male or female. Example......: Your sex <F>emale or <M>ale ? Type.........: Female character Description..: Character used in the Sex question for the Female. Example......: F Type.........: Male character Description..: Character used in the Sex question for the Male. Example......: M 3.2.4 Message base strings (Page 1) -------------------------------------------------------------- Strings used in the message base part of the SuperBBS program. Type.........: Board information string 1 Description..: String shown to user when reading or viewing messages. This string gives information about the active messages and the area name. The control codes Ctrl-KC (= active messages) and Ctrl-K5 (= name message board) can be used. Example......: Active message board: ^KC (^K5 act. messages) Type.........: Board information string 2 Description..: Shown to the user when reading or viewing mess- ages. This string gives information about the message numbers in the area. The control codes Ctrl-KD (= lowest message number) and Ctrl-KE (= highest message number) can be used. You will have to use a different line here if you have set the real message numbering system of SuperBBS on. You have to tell the user how many messages there are in the area, instead of on the system. In that case you use %1 for the lowest message number and %2 for the highest message number. Example......: System has messages numbered ^KD to ^KE. Area has messages numbered %1 to %2. Type.........: Pause question Description..: Shown to the user when SuperBBS asks the user if he/she wants to pause after each message. Example......: Pause after each message Type.........: Delete confirmation Description..: Shown to the user when SuperBBS asks the user if he/she really wants to delete the message. Example......: Are you sure -------------------------------------------------------------- SuperBBS v1.15 documentation Page 066 Type.........: End of replies Description..: Shown to the user when there are no more replies to be read. Example......: End of replies Type.........: End of messages Description..: Shown to the user when there are no more mess- ages to be read in the area. Example......: End of messages Type.........: Private question Description..: Shown to the user when SuperBBS asks him/her if the message is private or not. Example......: Private message Type.........: Use of alias question Description..: Shown to the user when SuperBBS asks the user if he/she wants to use his/her alias to write the question. Example......: Do you want to use an alias Type.........: Message abort string Description..: Shown to the user when the message is aborted. Example......: Message aborted ... Type.........: Jump number question Description..: Shown to the user when SuperBBS asks the user to which question he/she wants to jump. Example......: Enter message number to jump to : Type.........: Invalid number string Description..: Shown to the user when he/she entered a message number which did not exist. Example......: Invalid message number Type.........: Choose area string Description..: Shown to the user when SuperBBS asks the user to choose a message area. Example......: Choose message area : Type.........: Message to ALL string Description..: Shown to the user when he/she needs to enter the name for whom the message is for telling what to type if the message is to all. Example......: Enter 'ALL' if message is to everyone Type.........: Who to question Description..: Shown to the user when SuperBBS wants to know who the message is for. Example......: Who is the message to : -------------------------------------------------------------- SuperBBS v1.15 documentation Page 067 Type.........: Subject question Description..: Shown to the user when SuperBBS wants to know what the subject of the message is. Example......: Subject: Type.........: Alias in message question Description..: Shown to user when he/she wants to use an alias in the message, but is not using one. Example......: Choose alias to use: Type.........: Start number question Description..: Shown to the user when he/she has to enter the number of the message where SuperBBS has to start displaying. Example......: Enter number to start : Type.........: Name not found Description..: Shown to the user when the user entered a name which is not in the userfile. Example......: Name not in userfile 3.2.5 Message base strings (Page 2) -------------------------------------------------------------- Type.........: New messages Description..: Shown to the user when he/she searches for unread mail in the mail areas. Example......: Following areas have unread mail : Type.........: No new messages Description..: Shown to the user when there are no new mess- ages at an unread message scan. Example......: No unread messages found in any area ... Type.........: How many latest Description..: Shown to the user when he/she wants to read messages and SuperBBS asks how many the user wants to read. Example......: How many messages do you want to read ? Type.........: New string Description..: Shown to the user when there are unread mess- ages found at the mail scan of unread mail. The %1 string is replaced with the number of mess- ages. Example......: %1 new messages -------------------------------------------------------------- SuperBBS v1.15 documentation Page 068 Type.........: To you Description..: Shown to the user when there are personal unread messages found during the mail scan for unread mail. The %1 is replaced by the number of messages. This string is shown behind the previous string. If there are no personal mess- ages, this string is not shown. Example......: , %1 to you Type.........: Private string Description..: Shown to the user when a message is private. This string is shown in the header of the mess- age. Example......: private Type.........: Public string Description..: Same as previous string, except for public messages. Example......: public Type.........: Received string 1 Description..: Shown in the header of a message when the mess- age is received. Example......: Received Type.........: Received string 2 Description..: Shown in the header of a message when the mess- age is received. This string is followed by the date of the message it was received on. Example......: Received on Type.........: Kill/sent Description..: Shown in the header of a netmail message if this message has the kill/sent flag set. Example......: Kill/sent Type.........: Crash Description..: Shown in the header of a netmail message if this message has the crash flag set. Example......: Crash Type.........: Files Description..: Shown in the header of a netmail message if the file attach flag has been set for the message. Example......: Files Type.........: Sent Description..: Shown in the header of a netmail message if the message has the sent flag set. Example......: Sent -------------------------------------------------------------- SuperBBS v1.15 documentation Page 069 Type.........: Date field Description..: Shown in the header of the message to the user in front of the date of the message. Example......: Date : Type.........: From field Description..: Shown in the header of the message to the user in front of the name of the writer of the mess- age. Example......: From : Type.........: To field Description..: Shown to the user in front of the name of the receiver of the message. Example......: To : Type.........: Subject field Description..: Shown in the header of a message to the user indicating the subject of the message. Example......: Subj : Type.........: 1st line Description..: Shown in the header of the message, stating the message number and time and date of the writing of the message. Three control codes are used here: %1 Message number %2 Date of the message %3 Time of the message This is an indication of how old a message is. Example......: Message #%1 on "%2" %3 3.2.6 Message base strings (Page 3) -------------------------------------------------------------- Type.........: No write security Description..: Shown to the user when he/she has no rights, set in the messagebase part of the configur- ation, for writing in the area. Example......: You don't have write access Type.........: No read security Description..: Shown to the user when he/she has no rights, set in the messagebase part of the configur- ation, for reading in the area. Example......: You don't have read access -------------------------------------------------------------- SuperBBS v1.15 documentation Page 070 Type.........: No new messages Description..: Shown to the user when there are no new mess- ages in an area, while in area by area read. The control code %1 is replaced by the area number. Example......: No new messages in area %1. Type.........: Jumping to area Description..: Shown to the user when SuperBBS jumps to the next area, while in area by area read. Example......: Jumping to the next message area... 3.2.7 Message reading command key -------------------------------------------------------------- The following strings are used while reading messages on the system. They are the commands shown to the user at the end of a message. It is now possible to define these strings as you like. To tell SuperBBS which character is the command charac- ter, i.e. the key to activate the command, use the @ sign. The character behind this sign will be placed between brackets, to tell the user what the activate key is. Here's an example: ne@Xt message will be displayed as: ne<X>t message Take care you are not using the same character twice or more as an activate key! It is advised to keep the activate charac- ter the same as in the normal english commands, like R for reply and D for delete, although you could change the command word. Please note this is an advise, your free to do other- wise. Type.........: Next reply Description..: Command for reading the next message in the reply chain. Only shown when there is a reply chain. Example......: @+ Next reply Type.........: Previous reply Description..: Command for reading the previous message in the reply chain. Only shown when there is a reply chain. Example......: @- Previous reply Type.........: Quit reading replies Description..: Command to quit the reading of replies. Example......: @Quit reading replies Type.........: Again string Description..: Command to show the message again. Example......: @Again -------------------------------------------------------------- SuperBBS v1.15 documentation Page 071 Type.........: Next string Description..: Command for next message. Example......: @Next Type.........: Back string Description..: Command to show previous message. Example......: @Back Type.........: Jump string Description..: Command to jump to a certain message number. Example......: @Jump Type.........: Reply string Description..: Command for replying to the just read message. Example......: @Reply Type.........: Write string Description..: Command for writing a new message in the cur- rent area. Example......: @Write Type.........: Delete string Description..: Command for deleting the just read message. Example......: @Delete Type.........: Keep string Description..: Command to keep a message unread. Example......: @Keep unread Type.........: Copy string Description..: Command for copying a message. Example......: @Copy Type.........: Export string Description..: Command for exporting a message (to a printer or file). Example......: @Xport Type.........: Edit string Description..: Command for editing the current message. Example......: @Edit Type.........: Toggle private string Description..: Command to make a message private if public or public if private. Example......: @= Pvt/Public Type.........: Update user string Description..: Command for updating a user. Example......: @Update -------------------------------------------------------------- SuperBBS v1.15 documentation Page 072 Type.........: Stop string Description..: Command to stop reading messages. Example......: @Stop Type.........: Next area string Description..: Command to go to the next area while in area by area read. Example......: @Goto next area Please note that only those commands are shown to the User/Sysop which he/she has access to. 3.2.8 File area strings (Page 1) -------------------------------------------------------------- Strings shown to the user when he/she is in the file base part of the bulletin board. Type.........: File mask question Description..: Shown to the user just before SuperBBS displays the Files.bbs list. Here the user can enter a search pattern to look for. Example......: Enter filemask (ENTER = ALL) : Type.........: Batch download question Description..: Shown to the user when SuperBBS asks the user what he/she wants to download. Example......: Enter files to download (Wildcards valid) : Type.........: Filename question Description..: Shown to the user when SuperBBS wants to know the filename. Example......: Enter filename : Type.........: String search question Description..: Shown to the user when SuperBBS wants to know what string to look for. Example......: Enter string to look for in listings : Type.........: Name search question Description..: Shown to the user when SuperBBS wants to know what filename to look for. Example......: Enter filename to search for (Wildcards valid): Type.........: New file search question Description..: Shown to the user when SuperBBS asks the user the date to search from when scanning for new files. Example......: Enter date to search from (mm/dd/yy) ? -------------------------------------------------------------- SuperBBS v1.15 documentation Page 073 Type.........: Area change question Description..: Shown to the user when he/she wants to change from a file area to another. Example......: Choose file area : Type.........: Pack files question Description..: Shown to the user when SuperBBS asks the user which files need to be packed from the 'temp' directory option. Example......: Enter file names to pack (ENTER = STOP): Type.........: Delete files question Description..: Shown to the user when SuperBBS asks the user which files need to be deleted from the temp directory. Example......: Enter files to delete : Type.........: Not found string Description..: Shown to the user when a file is not found. Example......: File not found !! Type.........: No upload string Description..: Shown to the user when uploads are not allowed in the file area. Example......: No uploads allowed to this area Type.........: No download string Example......: Shown to the user when downloads are not allowed in the file area. Example......: No downloads allowed from this area Type.........: Files to upload question Description..: Shown to the user when SuperBBS asks the user what he/she wants to upload. Example......: Enter filenames to upload (ENTER = STOP) : Type.........: Before transfer question Description..: Shown to the user before the transfer is started. the user can press 'ENTER', which will start the transfer, press '!' to logoff after the transfer or press 'A' to abort. Example......: [ENTER] = start, [!] = logoff, [A] = abort Type.........: Start transfer Description..: Shown to the user when SuperBBS starts the transfer. Ctrl-X can interrupt the transfer. Example......: Start transfer. Press Ctrl-X to interrupt Type.........: File exist Description..: Shown to the user when a file already exist in the file base. %1 will be replaced by the filename. Example......: File %1 is already here ! -------------------------------------------------------------- SuperBBS v1.15 documentation Page 074 Type.........: Virus in file Description..: Shown to the user when a virus is detected in the uploaded file. %1 will be replaced by the filename. Example......: File %1 contains a virus ! Type.........: Not received Description..: Shown to the user when a file was expected, but not received. %1 will be replaced by the filename. Example......: File %1 was expected but not received ! 3.2.9 File area strings (Page 2) -------------------------------------------------------------- Type.........: Please describe Description..: Shown to the user when he/she has to describe the file uploaded to the BBS. This is the first information string shown. Example......: Please enter a description for your upload : Type.........: "/" = private file Description..: Shown to the user telling him/her that a '/' in front of the description will make the file private to the Sysop. Example......: (Begin description with '/' if Sysop file) Type.........: Please describe 1 Description..: Shown to the user when the user has to enter the first line of the file description. %1 will be replaced by the filename. Example......: Please describe %1 Type.........: Please describe 2 Description..: Shown to the user when he/she needs to enter the second to fifth line of the description. Example......: Press Enter to stop Type.........: Description to short Description..: Shown to the user when he/she has entered a to short file description. Example......: Description must be at least 4 characters Type.........: File is unwanted Description..: Shown to the user if he/she is planning to send a file which the Sysop doesn't want. (See the FILES.CTL part in the control file section of the docs.) %1 will be replaced by the filename. Example......: The file %1 is not wanted ! -------------------------------------------------------------- SuperBBS v1.15 documentation Page 075 Type.........: Files received Description..: Shown to the user when the files are received. %1 will be replaced by the number of files received. Example......: %1 files received. Type.........: Files sent Description..: Shown to the user when the files have been sent. %1 will be replaced by the number of files. Example......: %1 files sent. Type.........: No files found Description..: Shown to the user when SuperBBS can't find any files to send. Example......: No files found Type.........: Not enough time Description..: Shown to the user when he/she doesn't have enough time to download the file. Example......: You don't have enough time left Type.........: Password question 1 Description..: Shown to the user when he/she tries to download a file which is password protected. (See the FILES.CTL part of the documentation.) %1 is replaced by the filename. Example......: The file %1 is password protected ! Type.........: Password question 2 Description..: Shown to the user when he/she has to enter the password for the file. Example......: Enter password : Type.........: Select area string Description..: Shown to the user at the top of the screen if he/she is using the pick area change command. Example......: Select file area with cursor keys: Type.........: Select area info Description..: Shown at the bottom of the area pick screen, telling the user what to do when changing file areas. Example......: [ENTER]...Choice [A]...Choose area by number Type.........: Virus check question Description..: Shown to the user when he/she wants to check a file for viruses. Example......: Enter files to be checked : -------------------------------------------------------------- SuperBBS v1.15 documentation Page 076 Type.........: File offline string Description..: Shown to the user in the Files.bbs listing if the file is in the files.bbs list, but not in the directory. You can only use a limited num- ber of characters here. Example......: Offline 3.2.10 Other strings (page 1) -------------------------------------------------------------- Strings which can be found all over SuperBBS are defined here. Type.........: Press Enter string Description..: Shown to the user when he/she has to press ENTER to continue. Example......: Press [ENTER] to continue ... Type.........: Press S or P string Description..: Shown to the user when he/she can press S or P to stop or pause a listing. Example......: Press S to Stop or P to Pause listing Type.........: Please wait string Description..: Shown to the user when he/she has to wait, because SuperBBS is working. Example......: Please wait a moment ... Type.........: Yes character Description..: Character used in SuperBBS to represent the 'Yes' character. Example......: Y Type.........: No character Description..: Character used in SuperBBS to represent the 'No' character. Example......: N Type.........: Chat reason question Description..: Shown to the user when SuperBBS asks the user for the reason to chat. Example......: Reason for chat : Type.........: Chat start string 1 Description..: Shown to the user when the Sysop entered the chat with the user. this is the first line. Example......: Sysop chat mode entered ... Type.........: Chat start string 2 Description..: Second string shown to the user when the Sysop entered chat mode. Ctrl-FW can be used to dis- play the user's first name. Example......: Hello ^FW, this is your Sysop. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 077 Type.........: Chat info string Description..: Shown at the bottom of the full-screen chat screen. Example......: [^R] Redraw screen [^W] to clear your screen Type.........: Chat end string Description..: Shown to users when the chat is over. Example......: Sysop chat mode ended ... Type.........: Dos shell string 1 Description..: Shown to the user when the Sysop jumps to Dos level with Alt-J. Example......: Sysop has shelled to Dos, please wait ... Type.........: Dos shell string 2 Description..: Shown to the user when the Sysop returned from the jump to Dos. Example......: Sysop has returned from Dos. Thanks for waiting Type.........: Update string 1 Description..: Shown to the user when the Sysop is updating the user information. Example......: Sysop is updating you information ... Type.........: Update string 2 Description..: Shown to the user when the Sysop finished up- dating the user information. Example......: Sysop has done it ... The following strings are used when the user asks for the time statistics. (See menu options). Type.........: Current time string Description..: Shown when SuperBBS shows the user the time. The %1 will be replaced by the current time. Example......: Current time : %1 Type.........: Current date string Description..: Shown to the user when SuperBBS tells the user the date. The %1 will be replaced by the date. Example......: Current date : %1 Type.........: Connect time string Description..: Shown to the user when SuperBBS displays the time the user can be connected. The %1 will be replaced by the minutes, the %2 by the seconds. Example......: Connect time : %1 min %2 sec. Type.........: Time used string Description..: Shown when SuperBBS tells the user how much time he/she has been online. Example......: Time used : %1 min %2 sec. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 078 Type.........: Time left string Description..: Shown to tell the user how much time he/she has left over this call. Example......: Time left : %1 min. Type.........: Call limit string Description..: Shown to the user to tell the call limit. Example......: Call limit : %1 min. Type.........: Time in bank Description..: Shown to the user to tell the amount of time the user has in the timebank. Example......: Time in bank : %1 min. 3.2.11 Other strings (Page 2) -------------------------------------------------------------- Type.........: Bad phone number string Description..: Shown to the user when he/she entered a wrong telephone number. Example......: You have to enter a full telephone number ! Type.........: Password not changed Description..: Shown to the user when his/her password is not changed. Example......: Password not changed. Type.........: Ask current password Description..: Shown to the user when he/she wants to change the password and has to enter the current pass- word. Example......: Please enter your CURRENT password : Type.........: Current alias string Description..: Shown to the user when SuperBBS displays the user's current alias. Example......: your current alias is : Type.........: Combined string 1 Description..: Shown to the user when he/she wants to toggle areas on/off for the combined message board. This strings tells the user what to do. Example......: Enter board numbers to toggle on/off Type.........: Combined string 2 Description..: Shown to the user when he/she wants to toggle areas on/off for the combined message board. This string tells the user the commands to use at the toggle menu. Example......: ON=All On OFF=All Off T=Toggle D=Default -------------------------------------------------------------- SuperBBS v1.15 documentation Page 079 Type.........: Search user question Description..: Shown to the user when the user wants to search the userlist and SuperBBS asks for part of the name. Example......: Enter part of username to search for : Type.........: Search alias question Description..: Shown to the user when the user wants to search the alias userlist and SuperBBS asks for part of the alias name. Example......: Enter part of alias or username to search for : Type.........: More question Description..: Shown to the user when the maximum screen length is reached and the user has to state if he wants to continue or not. Example......: More <Y>es or <N>o ? Type.........: More Yes character Description..: Character used in the More? question as the Yes character. Example......: Y Type.........: More No character Description..: Character used in the More? question as the No character. Example......: N Type.........: 20 sec to inactivity Description..: Shown to the user 20 seconds before SuperBBS disconnects, if the user is inactive. Example......: * Warning : Only 20 seconds to hangup ! Type.........: Inactivity string Description..: Shown to the user at the moment SuperBBS dis- connects, because the user was inactive. Example......: User inactive, hanging up ... Type.........: Two minutes warning Description..: Shown to the user by SuperBBS when he/she has only 2 minutes left. Example......: * Warning : Only 2 minutes time left ! Type.........: Time exceeded string Description..: Shown to the user when SuperBBS disconnects because the user's time limit is exceeded. Example......: Time limit exceeded. Call back tomorrow ... Type.........: Yes string Description..: String used within SuperBBS for the Yes string. Example......: Yes -------------------------------------------------------------- SuperBBS v1.15 documentation Page 080 Type.........: No string Description..: String used within SuperBBS for the No string. Example......: No Type.........: Alias list top string Description..: String shown at the top of the alias list. This tells the user which row the alias is and which row the real name. Please note the location carefully. Example......: Name Alias 3.2.12 Other strings (Page 3) -------------------------------------------------------------- Type.........: Alias in use string Description..: Shown to the user if he/she selected an alias which is already in use. Example......: That's already in use, choose again ! Type.........: Invalid screen length Description..: Shown to the user when the user selected a wrong screen length. (Not between 12 and 60 lines.) Example......: Invalid screenlength entered ! Type.........: Password short string Description..: Shown to the user if a password is entered which is to short. (Min. 4 characters.) Example......: Password is to short. Try again ! Type.........: Password check failed Description..: Shown to the user when he/she entered his/her old password and it didn't match the real pass- word when changing passwords. Example......: Passwords do not match. Type.........: Password changed string Description..: Shown to the user when the password change was successful. Example......: Password changed successfully Type.........: Wrong string Description..: Shown to the user when entering a wrong pass- word. Example......: Wrong !! Type.........: Ask line number string Description..: Shown to the user when he/she has to enter a line number. Example......: Enter line number : -------------------------------------------------------------- SuperBBS v1.15 documentation Page 081 Type.........: Minutes in bank Description..: Shown to the user when SuperBBS shows the amount of minutes the user has deposit in the timebank. Ctrl-K7 can be used to display the amount in minutes. Example......: You have ^K7 minutes in the bank Type.........: Time left string Description..: Shown to the user stating how much time the user has left. Ctrl-KO can be used to display the amount of time left. Example......: You have ^KO minutes left Type.........: Deposit ? Description..: Shown to the user when he/she wants to deposit time in the bank. Example......: How much time do you want to deposit ? Type.........: Withdraw ? Description..: Shown to the user when he/she wants to withdraw time from the bank. Example......: How much time do you want to withdraw ? Type.........: You can deposit Description..: Shown to the user when SuperBBS tells the user how much time he/she can deposit. %1 is replaced by the maximum number of minutes the user can deposit. Example......: You can deposit %1 minutes. Type.........: Next user comment Description..: Shown to the user when he/she wants to enter a comment for the next user. Example......: Enter your comment for next user .... Type.........: Save comment ? Description..: Shown when the user needs to save the comment. Example......: Save comment Type.........: Message after page Description..: Shown to the user after an unsuccessful page attempt and before the user can enter a message to the Sysop. Example......: Would you like to leave a message -------------------------------------------------------------- SuperBBS v1.15 documentation Page 082 Type.........: Usage graph top Description..: Shown to the user as the top line of the graphical usage display of the system. The following control codes can be used: %1 Start date of usage graph %2 Current date %3 Number of days between %1 and %2 This line is shown as the first line on the screen. The information is taken from one of the SuperBBS control files, TIMELOG.BBS. Example......: System usage graph for %1 to %2 (%3 days) Type.........: Option not available Description..: Shown to the user when a menu option is not available due to opening hours of the menu function. (See menu functions 1, 2 and 4 for more information on this subject.) Two control codes are available: %1 Opening time menu option %2 Closing time menu option These time settings are all done in the optional data field of the menu option. Example......: Option is only available between %1 and %2. Type.........: Choose door string Description..: Shown to the user when selecting a door from the selection menu when using door templating. Example......: Choose door to run : Type.........: You're too young Description..: Shown to the user when he/she wants to enter a menu option which has a minimum age set and his/her age is not high enough. Example......: You're too young to enter this menu! 3.2.13 Status string configuration -------------------------------------------------------------- These strings are shown when the user toggles some setting on or off and when SuperBBS displays the settings. Type.........: "On" string Description..: The string to represent the word 'ON'. Example......: ON Type.........: "Off" string Description..: The string to represent the word 'OFF'. Example......: OFF -------------------------------------------------------------- SuperBBS v1.15 documentation Page 083 Type.........: Screen clear status Description..: String to tell the user the status of the screen clear command. The %1 will be replaced by the ON or OFF string. (See above). Example......: Screen clears are now %1 Type.........: More status Description..: String to tell the status of the more prompt. Example......: More prompts are now %1 Type.........: Ansi status Description..: String to tell the status of ANSI graphics. Example......: Ansi graphics are now %1 Type.........: Ansi editor status Description..: String to tell the status of the full screen ANSI editor. Example......: Full screen ANSI editor is now %1 Type.........: Mail check status Description..: String to tell the status of the mail check at logon. Example......: Mail check at logon is now %1 Type.........: New files status Description..: String to tell the status of the new files check at logon. Example......: New files check at logon is now %1 Type.........: Disturb mode status Description..: String to tell the status of the 'Do not disturb' flag. Example......: Do not disturb mode is now %1 Type.........: Full screen viewer status Description..: String to tell the status of the full screen message viewer. Example......: Full screen message viewer is now %1 The following strings are used in conjunction with the Sysop availability option in SuperBBS. (Num-lock On/Off). Type.........: Available string Description..: String to represent the word 'Available'. Example......: Available Type.........: Unavailable string Description..: String to represent the word 'Unavailable'. Example......: Unavailable -------------------------------------------------------------- SuperBBS v1.15 documentation Page 084 3.2.14 Month names -------------------------------------------------------------- Here you can define the abbreviations for the twelve month. These will be used if SuperBBS has to display the month. Don't use more than 3 characters for the abbreviations. You can also use the numerical code for the month, i.e. Jan = 01, Feb = 02, Mar = 03 etc. 3.2.15 Weekday names -------------------------------------------------------------- Here you can define the weekday names. Both a long and short version is used. The long version is the full name, the short version is the abbreviation. 3.2.16 BBS List strings -------------------------------------------------------------- These strings are used when using the BBS list options build into SuperBBS. Except for one string, they are all used to display the BBS information in the list. Type.........: BBS name string Description..: Shown in front of the BBS name. Example......: Name : Type.........: BBS phone string Description..: Shown in front of the phone number. Example......: Phone : Type.........: BBS max. speed Description..: Shown in front of the modem speed. Example......: Max speed : Type.........: BBS open string Description..: Shown in front of the opening hours. Example......: Open hours : Type.........: BBS software string Description..: Shown in front of the BBS software. Example......: Software : Type.........: BBS address string Description..: Shown in front of the node number. Example......: Node number : Type.........: BBS sysop string Description..: Shown in front of the Sysop name. Example......: Sysop : -------------------------------------------------------------- SuperBBS v1.15 documentation Page 085 Type.........: BBS other string Description..: Shown in front of the other information. Example......: Other : Type.........: BBS to delete string Description..: Shown to the Sysop who wants to delete his/her BBS from the BBS list. Example......: Enter BBS to delete from list : 3.2.17 Multi line status strings -------------------------------------------------------------- These strings are shown to the user when he/she asks for the status of the available lines. Type.........: Status string #1 Description..: Shown to the user when the user(s) on the other line(s) is(/are) doing nothing special, like staring at a menu screen. Example......: Doing nothing special Type.........: Status string #2 Description..: Shown to the user when the user(s) on the other line(s) is(/are) downloading. Example......: Downloading Type.........: Status string #3 Description..: Shown to the user when the user(s) on the other line(s) is(/are) uploading. Example......: Uploading Type.........: Status string #4 Description..: Shown to the user when the user(s) on the other line(s) is(/are) reading messages. Example......: Reading messages Type.........: Status string #5 Description..: Shown to the user when the user(s) on the other line(s) is(/are) writing messages. Example......: Writing messages Type.........: Status string #6 Description..: Shown to the user when the user(s) on the other line(s) is(/are) chatting with the Sysop. Example......: Chatting with Sysop Type.........: Status string #7 Description..: Shown to the user when the user(s) on the other line(s) is(/are) using an external program. Example......: Using external program -------------------------------------------------------------- SuperBBS v1.15 documentation Page 086 Type.........: Status string #8 Description..: Shown to the user when the user(s) on the other line(s) is(/are) logging on. Example......: Logging on Type.........: Status string #9 Description..: Shown to the user when the system is waiting for another caller or event. Example......: Waiting for a call or event Type.........: Status string #10 Description..: Shown to the user when the line is down. Example......: Down Type.........: Status string #11 Description..: Shown to the user when the user(s) on the other line(s) is(/are) using the QWK system. Example......: Using QWK system 3.2.18 QWK strings -------------------------------------------------------------- These string are shown when using the QWK offline reader build in to SuperBBS. Support this system and make the options available to your users. Type.........: Reply not found Description..: Shown to the user when the file with replies is not found. These files have the .REP extension. Control code %1 can be used for the filename. Example......: %1 not found ... Type.........: QWK format question Description..: Shown to the user when SuperBBS asks the user if he/she wants to download the messages in QWK format or in ASCII format. Example......: Download the packet in .QWK format Type.........: Limits is # messages Description..: Shown to the user when he/she wants to download more messages than the limit is set to. Control code %1 is used to display the message limit. Example......: Sorry, the limit is %1 messages Type.........: Messages exported Description..: Shown to the user when SuperBBS is about to pack the messages. The control code %1 is used to display the amount of messages exported from the messagebase. Example......: %1 messages exported -------------------------------------------------------------- SuperBBS v1.15 documentation Page 087 Type.........: Packing messages Description..: Shown to the user when SuperBBS is packing the messages after they were exported from the messagebase. Example......: Packing messages. Please wait .... Type.........: No new messages Description..: Shown to the user when there are no new mess- ages in the message areas selected. Example......: Sorry, no new messages found ... Type.........: Message moved Description..: Shown to the user when his/her message(s) is(/are) moved to the default message area for some reason. Example......: Message has been moved to the default area Type.........: Upload question Description..: Shown to the user when SuperBBS asks the user if he/she wants to upload a reply packet. The control code %1 is used to display the filename. Example......: Do you want to upload %1.REP Type.........: Max # messages to pack question Description..: Shown to the user when SuperBBS needs to know how many messages to pack for the user. Example......: Maximum number of messages to pack : Type.........: Update pointers question Description..: Shown to the user when SuperBBS asks him/her if the lastread pointer has to be updated. Example......: Update lastread pointer Type.........: Choose packer string Description..: Shown to the user when SuperBBS asks for the default archiver to use. Example......: Choose your default archiver : 3.2.19 A little help -------------------------------------------------------------- Just a little help screen with the most important options, so you have a quick reference guide incase you don't know a certain control code. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 088 3.3 Control codes in strings -------------------------------------------------------------- SuperBBS allows the use of control codes in the strings which you define in Lconfig. These strings can be display different colours or it is even possible to display an ANSI/ASCII file. Colours are brought into the strings with the Ctrl-C and then the colour code. These are the colour numbers: 000. Black 001. Blue 002. Green 003. Cyan 004. Red 005. Purple 006. Brown 007. Grey 008. Dark grey 009. Light blue 010. Light green 011. Light cyan 012. Light red 013. Light purple 014. Yellow 015. White When you want to insert a control code in a string, you first have to press Ctrl-P to tell SuperBBS you are entering a control code. Here's an example: The file ^C014 %1 ^C003 is not wanted ! Enter the string first, then move to the place where you want to insert the colour code. Press Ctrl-P, Ctrl-C and 014. this will make the text behind it yellow. Repeat the sequence if you want another colour in a different spot. Always fill the colour code out to 3 characters. Example: Dark grey is: 008 (and not 8) Yellow is: 014 (and not 14) If you want to make the prompts appearing after a piece of text in the same colour as the last used colour, use this command: Ctrl-C !. This will return the colour of the last used text display. This could be used to set the 'More Y/N prompt in the same colour as the displayed text before it. All control codes, as described later in this manual, can be used in the strings. Just press Ctrl-P first, before entering the code. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 089 Another powerful option is the possibility of displaying an ANSI/ASCII file instead of the string. This can be achieved through the use of the Ctrl-A code and the filename to dis- play. Here's an example for the string used for the not wanted files: <Ctrl-A>UNWANTED This will display the ANSI/ASCII file UNWANTED when a file is not wanted. The file has to be in the text directory specified in the configuration. Don't forget to press Ctrl-P before entering the Ctrl-A code. 3.4 Language.ctl file -------------------------------------------------------------- You will need to make a file called LANGUAGE.CTL. This file is the control file for the languages available. This file is a plain ASCII file with the following format: <Language filename> <Language filename> <Language filename> This file has to be in every line directory with multiline systems. This way you could run an English system on one line and an English and Dutch on the other line. The first language will be the language SuperBBS starts in. This means that any string shown to the user before he/she entered his/her name is from this language file. Until a caller entered his/her name, SuperBBS doesn't know which language the user is using. When a new user calls to your BBS, some textfiles will be shown to him/her before SuperBBS will ask which language they want. These files are: - NOTFOUND.A?? - NEWUSER1.A?? See for more information about these files the textfile part of this documentation. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 090 3.5 Hints and tips -------------------------------------------------------------- If you have problems understanding what all the strings are for in the language configuration program, use the following method of making a language file: - Copy the supplied ENGLISH.LNG file to your own name. - Start Lconfig with the new .LNG name. - Edit the strings. You will know what the original looks like and you'll be able to see where the special characters are used. (Characters like : and ?) - Exit the program after you're ready. This way it is easy to write a new language file in any lan- guage you like. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 091 Chapter 4. Converting from other software ============================================================== 4.1 General information -------------------------------------------------------------- SuperBBS is a QuickBBS based bulletin board system. Converting from other software to SuperBBS is simple, as long as you use a program also based on QuicKBBS. Otherwise a complete revision of your menus and textfiles may be needed. For users of the RemoteAccess software is a special conversion program available. 4.2 Converting from QuickBBS, Proboard or RemoteAccess -------------------------------------------------------------- When converting to SuperBBS from QuickBBS or RemoteAccess, your userfile, messagebase and most systemfiles can be used by SuperBBS. There are some different menu options and some controlcodes are not the same. SuperBBS can store it's mes- sagebase anywhere you want, which is not available in QuickBBS. If you do run into serious trouble converting from QuickBBS or RemoteAccess to SuperBBS, contact one of our Support nodes or the SuperBBS HQ. You will need to run USERFIX.EXE on your userfile. This pro- gram will scan your userfile so it won't have trouble with the 7/8 bits characters used in Scandinavian countries. SuperBBS fully supports these characters. Put the USERFIX.EXE file in the same directory as your USERS.BBS file is and run the program. 4.3 Converting from other software -------------------------------------------------------------- Converting from other software than QuickBBS, Proboard and RemoteAccess is more difficult. Mostly your userbase is not compatible and the same is for your messagebase. The SuperBBS structures are available, if you need to write conversion programs. Most Support boards have these structures available. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 092 Chapter 5. Menus ============================================================== 5.1 General information -------------------------------------------------------------- Just like QuickBBS and RemoteAccess is SuperBBS using a menu system that requires to be build up from scratch. (Although an easy installation program with some simple menus is included.) You will have to setup all menus and external screens. Super- BBS does include it's own menu program, which has all options available. It also supports 'unknown' menu options, so you can always use it. At this moment it is the only menu editor which supports the multi language options in SuperBBS. Any other menu program for QuickBBS is usable, as long as it supports 'unlisted' menu types, since SuperBBS has more menu options than QuickBBS has. There are several ways to setup a menu system for your BBS. The most used one looks like this: -------------------- Message menus | Main menu ------------------------- File menus | -------------------- Other menus Another method is to set up your menus by item: Main menu ------------------------- SuperBBS file & message | |------------------- Modem file & message | -------------------- Graphics file & message Either way, plan your menu structure carefully. Users like a menu structure which is easy to follow. Building a menu can be done in two ways. You can either build the whole menu with the menu editor, so text is displayed if needed, or you can start your menu with an ANSI/ASCII display option (with Hot-key) which will display the menu and have all the commands in the menu file. Both have advantages and disad- vantages. Using an ANSI/ASCII file as menu gives you the advantages that you can use more colours on one line, use graphics and even animation. Disadvantage is that all menu options will be visible to all callers, whatever securitylevel they have. You need to setup a display file option with a Crtl-A code, which means the command will be executed automatically. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 093 Using the normal menu has the advantages that you can hide several options from other security levels. Disadvantage is the limited use of colour per line. It will be up to you which way you choose. Be sure to check your menu files at every securitylevel you have set up. Strange things can happen if you make mistakes. Building a menu is simple, building a complex menu with many different options for different securitylevels is more diffi- cult. Take your time is a good advice. When building a menu, you will need to enter the following information: Text to display Text shown to user for this menu option. (Leave this empty if you use an ANSI/ASCII file to display the menu.) This line should contain a description and the char- acter to activate it. Optional data Optional data needed for the given menu type command. (See the menu commands.) Menu type Number of the menu type. (These will be listed below with a full description and the optional data needed.) Security Securitylevel needed to access this menu option. Key Key which activates this menu option. This can be any character on the keyboard. Foreground Colour in which the foreground of the text to display will appear. (Options: 0-15) Background Colour in which the background of the text to display will appear. (Options: 0-7) Flags A-D Flagsettings needed to access this menu option. Two special options are: Highlight colour The highlight colour is a colour which can be displayed on the text to display line through using a '^' in front and behind the text you want 'highlighted'. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 094 An example: Foreground colour: 2 Background colour: 0 Highlight colour...: 14 Text: This is a ^test^ for a menu. Result: This is a test for a menu. The word 'test' will appear in yellow, the rest of the line in dark green. Note that the special characters are not shown when displaying a menu. Prompt Line displayed below the menu options, prompting the user for an action. This line can have a different colour. Note that the supplied SuperBBS menu editor works a bit diffe- rent. But you still have to supply the above information. See the external utilities part of the documentation for infor- mation on the SuperBBS menu editor. These descriptions can differ from menu program to menu pro- gram, but the main idea stays the same. Use a menu editor which has an option for 'unknown' commands, since SuperBBS is expanding faster than the menu editors are, so you will be able to use the editor in the future. 5.2 Menu commands -------------------------------------------------------------- Now for the available menu commands. SuperBBS is pretty power- ful and has a lot of features, so read carefully. Make sure you take note of any optional data needed to set up a menu option. Without this data the menu option will not work or behave strangely. Used characters in the optional data fields: None = means no optional data needed xxxxxxx = means the data entered here is mandatory. <xxxxx> = means the data entered here is optional. The menu commands: Type.........: 0 Description..: Text line Display's the text you've entered in the menu editor for this command. No other action takes place. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 095 Type.........: 1 Description..: Goto a new menu. Will change the menu to the menu set up in the optional data field. Optional data: MenuName </F> </M> </NS> </T> </A> <Password> If you want to protect your menu with a pass- word, enter it behind the menu name, separated with a space. Enter the menu name without the .MNU extension. See for the /F and /M the part in this documentation about 'menu templating'. The /NS option will not send a CLS code before displaying the menu. The /T option is used to set opening hours on the menu option. You will have to use it in this way: /T??:??-??:?? The first ??:?? is the start time, the second ??:?? is the closing time of the menu option both in 24 hour format. When the menu option is closed, a message will be displayed. The /A option is used to set a minimum age for the menu option. You will have to use it in this way: /A???, where ??? is the age. If the user is too young, a message is displayed. The password has to be the last option on the line. Type.........: 2 Description..: Gosub to a new menu. Same as option 1, with the difference that the previous menu (the menu you left from) will be added to the stack of menus you've visited. This way you can follow the trail back through your menus. Optional data: MenuName </F> </M> </NS> </T> </A> <Password> The same as for menu type 1. Type.........: 3 Description..: Return from last gosub. Return to the menu you last visited. This option only works if you use the type 2 menu option to get to a menu. Optional data: None or /NS You don't have to enter any menu name, since the stack contains the name of the menu visited last. This name is erased after the return, so you can use menu type 3 again to return to the before last used menu. The /NS option will not send a CLS code before entering the previous menu. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 096 Type.........: 4 Description..: Goto new menu and clear gosub stack Clears the gosub stack used with menu options 2 and 3. Then goes to the given menu in the optional data field. Optional data: MenuName </F> </M> </NS> </T> </A> <Password> The same as for menu type 1 Type.........: 5 Description..: Display .ANS/.ASC file Display a textfile from the textfile directory setup in CONFIG.EXE and LCONFIG.EXE. SuperBBS first looks in the current language text direc- tory. If not found, SuperBBS will look in the directory specified in CONFIG.EXE. If a user has ANSI on, SuperBBS will first look for an ANS file, then for an ASC file. If the user has ANSI off, SuperBBS only looks for the ASC file. Optional data: FileName The filename to be displayed, without exten- sion. Type.........: 6 Description..: Selection menu Display a textfile which has up to 9 options available of other text files and display the Selection menu prompt, as set up in the CONFIG.EXE program. You will need to name all files the same, except for the last number. Suppose your main file is called BULLET.ANS then your other files will be called BULLET1.ANS to BULLET9.ANS. (If you have 9 files.) The main file is shown to the user. The user selects from the list displayed in the main file, which file he/she wants to read. If the user selects 3, the file BULLET3.ANS (or ASC) will be displayed. If the user selects 5, the file BULLET5.ANS will be displayed. After viewing the file, the user will be shown the main file again. Optional data: FileName This filename can be 7 characters or less. (Character 8 is reserved for the other textfile numbers.) The extension is always ANS or ASC and the files should be in your textfiles directory. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 097 Type.........: 7 Description..: Shell to DOS and run program This option is used for starting other pro- grams, like doorgames and mailscanners, in SuperBBS. It shells to DOS and starts the pro- gram given in the optional data field. SuperBBS will return to the menu the exit started from. Optional data: ProgramName <Parameters> This menu is one of the difficult menu options available, because of the large amount of para- meters. These are the parameters available: *B Caller's bps rate. This will be 0 if local, or 300 to 38400 if online. *C Full path to your COMMAND.COM file as set in the environment variable COMSPEC. (Con- sult your DOS manual for more information about COMSPEC.) This parameter is needed if you want to start a batchfile from this type 7 menu command. *E Read EXITINFO.BBS when returning to BBS. This can be handy if the program used with the type 7 exit, changes some of the user's data, like a timebank. *F User's firstname. *G Status of ANSI graphics. (0=Off, 1=On) *H Leave the Fossil driver (X00 or compatible) hot when exiting from SuperBBS. Some programs require this. (Most don't.) *I Path of current language file. *L User's lastname. *N Gives current node number. *P Gives current COM port number. *R User's recordnumber in the user database. *S Swap SuperBBS to EMS or disk. If you run a program which needs more memory than the normal amount available, specify the *S option, so SuperBBS will swap itself to EMS or, if EMS is not available, to disk. *T Time left this call. *U Path to current template file area. *X Template filename. SuperBBS now can pro- duce any kind of (ASCII style) exit file, supporting doors not made for SuperBBS. Create a template file with the extension .SBE and set it up as the door might need it. You have all control codes available. When you use the *X option in a type 7 exit, SuperBBS will replace the template given in the optional data field, like *XFilename.SBE, to create the exitfile Filename.EXT. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 098 Example: Exit template file: (TEST.SBE) ^FA ^FB ^KO ^KV Would give you an exitfile looking like this: (TEST.EXT) Aki Antman Helsinki, Finland 45 290 Being the full username, city, remaining time online and time of next event. Mostly you just use the *C and *S parameters. With multi-node operations, you will need the *N and *P options. Normally the documentation from the program you wish to run will supply the needed information. Type.........: 8 Description..: Version and copyright notice This option will show the user the version- number, copyright message and if your program is registered, the registration name of the SuperBBS version you're using. Optional data: None Type.........: 9 Description..: Logoff from the system This will disconnect the user from your system. Before disconnect, SuperBBS will show the user the GOODBYE.ANS (or ASC) file, if available. When using high speed modems, it might be needed to put a Ctrl-A at the end of the file, otherwise slow modems won't see much of the screen. Optional data: None Type.........: 10 Description..: Display System Usage graph Show the user the system usage graph. This gives you the percentage use per hour. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 099 Type.........: 11 Description..: Page the Sys(tem)Op(erator) for a chat See if the Sysop is available to talk to you. SuperBBS will ask the user for a reason for the chat. If the Sysop is not available, this rea- son will be stored in the SYSTEM.LOG file. Optional data: Prompt </FORCED> Enter the string, which will be shown to users who try to yell you. The /FORCED option will even start the yell outside yelling hours. Useful if you want your co-sysop or special users to call you even outside chat hours. Type.........: 12 Description..: Execute questionnaire file Execute the given questionnaire, for example NEWUSER.Q-A. The answers will be written in the same file name as the questionnaire, but the extension will be changed to .ASW. Optional data: FileName Extension of a questionnaire must be .Q-A or SuperBBS will not recognize the questionnaire. Answers will be written in the .ASW file. Type.........: 13 Description..: List/search user list Gives the option to search for a name in the userlist or display the whole list. Optional data: None, /S or /L If you specify no optional data, the list will contain no security levels. With the /S the securitylevels will be shown to the user. The /L option only shows the users with the same or lower security level. Type.........: 14 Description..: Time statistics Shows the user how long he/she has been on-line and how much time is left. Also gives the cur- rent date and time. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 100 Type.........: 15 Description..: Exits to DOS with errorlevel Leaves SuperBBS and returns to the batchfile which you ran SuperBBS from. There you inter- cept the given errorlevel and start an external action. (For more information about error- levels, consult your DOS manual and see the batch examples in the appendixes of this man- ual.) If possible you should use a type 7 exit, instead of this type 15. Use the *S (and *E) when using a type 7. Optional data: Errorlevel <MenuName> The errorlevel will start the action required from your batchfile. (Don't use errorlevel below 10.) The optional MenuName tells SuperBBS to which menu it should return after ending the type 15 exit. You should restart the SuperBBS program with the -R option. (See Command Line Parameters.) Type.........: 16 Description..: Change City & State Allows the user to change his/her City and State. Optional data: None Type.........: 17 Description..: Change password Allows the user to change his/her Password. Optional data: None Type.........: 18 Description..: Change screenlength Allows the user to change his/her screenlength. Optional data: None Type.........: 19 Description..: Toggle screen clearing on/off Allows the user to toggle the sending of screen clear codes (CLS) on and off. Optional data: None Type.........: 20 Description..: Toggle the 'More (Y/n)' prompt on/off Allows the user to toggle the more prompt on and off. Optional data: None Type.........: 21 Description..: Toggle ANSI graphics on/off Allows the user to toggle the ANSI graphics on and off. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 101 Type.........: 22 Description..: Scan for personal mail This option will scan the userbase and report any unread personal mail. Optional data: None </A> </G> The /A option tells SuperBBS to scan for new normal messages and for new group messages, while the /G option tells SuperBBS to only scan for new group messages. (See the chapter on the messagebase for more information on the group messages.) Type.........: 23 Description..: Read messages Allows the user to read messages in the current message area. If a message is private, it will be skipped if it is not from you or to you. Optional data: AreaNumber or /M Area number of the message base the messages should be read from. (If you use menu templa- ting, this can also be the templating command /M.) Type.........: 24 Description..: Scan messages Gives a list of messages with the header infor- mation (who from, who to and subject) and gives you the option to mark messages for later read- ing. Optional data: Areanumber or /M Area number of the message base the messages should be scanned from. Type.........: 25 Description..: Quick scan messages Gives a list like display of all messages in the area with information about the sender, receiver and subject. Optional data: AreaNumber or /M Area number of the message base the messages should be scanned from. Type.........: 26 Description..: Delete messages Removes messages from the message base. This only works for messages from you or to you. (Unless you have Sysop access to this area.) Optional data: AreaNumber or /M Area number of the message base the messages should be deleted from. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 102 Type.........: 27 Description..: Write a message Allows the user to write a message. Optional data: AreaNumber or /M </L> </T=First_Lastname> Area number of the message base to write the message in or the menu templating command /M. The /L will log the user off your system after saving the message (with displaying the file GOODBYE.A??). The /T=First_Lastname will send the message to the name given. Spaces should be set with the underscore character. The /L and /T option only works correct if you use an area number and NOT the /M command. You could use the /L and /T parameters for sending a message to the Sysop at logoff. If you leave this field blank, SuperBBS will use this menu option as an global write option and will ask the user in which area he/she wants to write the message. Type.........: 28 Description..: Select combined message areas Area 0 is a special message area. You can't write a message in this area, but you can read messages from all areas connected in numerical order. This option allows the user to select the areas he/she wants to use in his/her com- bined board. You can select standard areas or exclude areas from the combined board in the CONFIG.EXE program, the Message base part. Optional data: None Type.........: 29 Description..: Move a file Normally spoken an option only available to the Sysop. It will allow you to move a file from one area to another. It also moves the descrip- tion in the FILES.BBS file. Optional data: FullPath or /F You need to give the full directory path from where the file will be moved or the /F if you use menu templating. Type.........: 30 Description..: MS-Dos directory Like a normal DIR command, will SuperBBS dis- play the given directory. Optional data: FullPath or /F Give the full directory path or the /F. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 103 Type.........: 31 Description..: List FILES.BBS The normal way to show a user what's available in the given directory. It will show the filename, date, size and description. For CD- Rom users is an option build in to have the FILES.BBS file in a different location then the files itself are. See the CONFIG.EXE program, the File area editor. SuperBBS will ask the user for a file mask to display. There is also an option to only dis- play the newfiles. this is done by entering /N at the filemask question. Optional data: FullPath or /F Supply the directory or the /F command. CD-Rom users should use the /F command. Type.........: 32 Description..: Download a file This option will send a file from the BBS to the user. Optional data: None <FullPath> </F> <PassWord> If you leave the optional data field empty, SuperBBS will use this command as a global download command. It will search in every area the user has access to, trying to find the requested file. Use the full path or the /F option and SuperBBS will only look in the cur- rent area. The FullPath and /F option allow the use of a password, which need to be given before the download will be started. Please note that the <*> option is no longer supported. This is replaced with an option in the FILES.CTL file. Please delete the * from your optional data fields, otherwise SuperBBS will ask for a password before downloading. Type.........: 33 Description..: Upload a file This option will receive a file which the user sends to the BBS. Optional data: FullPath or /F Supply the full directory or the /F option. By using the full directory command, it is poss- ible to receive all uploads in one directory. The /F will place the file in the current area. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 104 Type.........: 34 Description..: View an archived file Shows what the archive file contains. It sup- ports ZIP, LZH, PAK and ARC files. Optional data: FullPath or /F Supply the full directory path or the /F option. Type.........: 35 Description..: Search for file by Keyword Look for a word in the FILES.BBS files. Optional data: None Type.........: 36 Description..: Search for file by Filename Look for a file in the FILES.BBS files. Wild- cards are allowed as search options. Optional data: None Type.........: 37 Description..: List new files on system Shows the new files since the last login or the given date. Optional data: None Type.........: 38 Description..: Type a textfile Allows the users to read a textfile on-line from your FILES.BBS list. (If there is a text- file in there.) Optional data: FullPath or /F Supply full directory path or the /F option. Type.........: 39 Description..: Display a textfile Show the user a textfile. This option is like menu option 5, except you have to supply the fullpath and filename. This allows you to show any file you want. No 'Press Return' is given at the end of the file. Optional data: Fullpath+FileName Supply the full path and filename to the text- file. Including the extension! -------------------------------------------------------------- SuperBBS v1.15 documentation Page 105 Type.........: 40 Description..: Display ANS/ASC file with Hotkey Show the user an ANSI or ASCI file, but keep the hot keys active. This can be used to dis- play a menu file. If you use this command to show the file, the user doesn't have to wait till the whole screen is drawn, but can make his choice at once. With a type 5 menu, the hot keys are not active during the display of the file. This command is mostly used in combina- tion with a Crtl-A command in your menu. (Crtl- A = Automatic execution) Optional data: FileName Supply the filename to be shown. Don't give an extension, as SuperBBS will always look for a ANS or ASC extension. The file has to be in the textfile directory. Type.........: 41 Description..: Toggle Full Screen editor on/off If you have a full screen editor installed, like Quicked, you can allow your users to toggle the editor on and off with this option. If it is off, the build in editor will be used. Optional data: None Type.........: 42 Description..: RESERVED - Do not use Type.........: 43 Description..: RESERVED - Do not use Type.........: 44 Description..: RESERVED - Do not use Type.........: 45 Description..: Display ANS/ASC file with 'Press ENTER' The same as menu type 5, except that SuperBBS will put a 'Press ENTER to continue' prompt after it showed the file. This will pause the screen till a reaction from the user is received. Optional data: FileName or fullpath and filename Supply the filename, without extension. The file has to be in the textfile directory. If you supply the filename and path, you can dis- play any file and have the 'Press Enter' at the end. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 106 Type.........: 46 Description..: Show GIF pictures resolution Show the resolution of the GIF picture (only of if it is stored on you disk as a .GIF file), which name is supplied by the user. This option doesn't look in archives! Optional data: FullPath or /F Supply the full directory path or use the /F option. Type.........: 47 Description..: Write entry to System log Write the text, given in the optional data field, to the SYSTEM.LOG file. This is handy if you want to know if a menu option is used or for any other information. Optional data: Text to be written The text given in this field will be written to the system logfile. Type.........: 48 Description..: Download a specific file By using this option, you only ask the user which download protocol he/she wants to use and then starts the download. You supplied the filename in the optional data field. This can be used to download your ALLFILES list. Optional data: FullPath+FileName Supply the file the users can download through the use of this option. Type.........: 49 Description..: RESERVED - Do not use Type.........: 50 Description..: RESERVED - Do not use Type.........: 51 Description..: RESERVED - Do not use Type.........: 52 Description..: RESERVED - Do not use Type.........: 53 Description..: Toggle mailcheck at logon on/off Allows the user to toggle the mailcheck at logon on and off. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 107 Type.........: 54 Description..: Toggle newfiles check at logon on/off Allows the user to toggle the newfiles check at logon on or off. Optional data: None Type.........: 55 Description..: Show BBS list (Short) Shows the user the build in BBS list in the short version. Optional data: None Type.........: 56 Description..: Add BBS to BBS list Allows Sysops to add their BBS to your BBS list. Information like telephone number, name, on-line hours, software and Sysop name are stored. Optional data: None Type.........: 57 Description..: Leave comment to next user A comment of 2 lines can be left behind for the next user. This will be shown to the next caller at logon. The user will not be logged off after entering the comment. Optional data: None Type.........: 58 Description..: Show callers Gives a list of the last 15 callers with the time they came on-line and went off-line. Also shown are bps rates and age. Optional data: None or /T If no optional data is specified the list will display the last 15 callers of all available lines. With the /T option, the list will con- tain all callers since midnight. Please note that the filename for this option has changed. The file used is now called SCALLERS.BBS and the old file SLCALLER.BBS is no longer used and can be deleted. Type.........: 59 Description..: Change colour configuration Allows the user to change the colour configur- ation of the BBS. This is the same as in the CONFIG.EXE program, but only works for the current user, while the CONFIG.EXE part, works for every user. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 108 Type.........: 60 Description..: Extract files Allows the user to extract a file, then after- wards he/she can view the files inside the archive and repack (some) files. All from with- in SuperBBS. Optional data: None <FullPath> </F> If you leave the optional data line empty, it means extract the file which is IN the TEMP directory. This TEMP directory is setup in the CONFIG.EXE program. If you enter the full directory path or the /F, for menu templating, this menu type will react as extract TO the TEMP directory. Note the difference! Type.........: 61 Description..: Archive files The user will be asked which files have to be archived. This option is to be used with the extract option, menu type 60. Optional data: FullPath or /F If you enter the full directory path of the TEMP dir, the files will be packed from that area. If you use the /F or the full directory path to your file areas, the requested files from that area will be packed. Type.........: 62 Description..: Delete files The user will be asked which files have to be deleted. This option is to be used with the extract option, menu type 60. Optional data: FullPath or /F If you enter the full directory path of the TEMP dir, the files will be deleted from that area. If you use the /F or the full directory path to your file areas, the requested files from that area will be deleted. Type.........: 63 Description..: Show BBS list (Long) Show the user the long version of the BBS list. The user has the option to enter the name he/she wants to look for. All available data about the BBS will be shown. Optional data: None Type.........: 64 Description..: Change BBS information in BBS list Allows Sysops to change their BBS data in the BBS list. Only you and the person named as Sysop in the BBS list is able to do this. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 109 Type.........: 65 Description..: Delete BBS information from BBS list Allows Sysop to remove their data from the BBS list. Only you and the person named as Sysop in the BBS list is able to do this. Optional data: None Type.........: 66 Description..: Download BBS list Allows users to download the BBS list. Only the protocol will be asked for. Optional data: None Type.........: 67 Description..: Change user's phone number(s) Allows the user to change his/her phone num- ber(s). Optional data: None Type.........: 68 Description..: Select message area from arealist Allows the user to change area with the build in area change command. This will display a three row list of all the available (to this user) message areas. Use this for changing areas when using menu templating. Optional data: None Type.........: 69 Description..: Select file area from arealist Allows users to change area with the build in area change command. This will display a one row list of all the available (to this user) file areas. Use this for changing areas when using menu templating. Optional data: None, /P or /2 If you use the /P, the change area command will change into a pick area command for ANSI users only. The user can select an area from the list with the cursor control keys. Local users should use the cursor control keys on the numeric keyboard with NUMLOCK on. (The other cursor keys are used to change the online time). The /2 command will give you two rows instead of the one single row when no optional data is given. With this option, your area names have to be shorter than 30 characters, but it allows you to display twice as much areas on screen at once. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 110 Type.........: 70 Description..: Change alias Allows the user to change his/her alias. Only works if you allowed the use of an alias on your system. Optional data: None Type.........: 71 Description..: List aliases Shows an user - alias list of all users. The user is given the option to select a search criterium. Optional data: None Type.........: 72 Description..: Show user's balance in the timebank Allows the user to see how much time he/she has deposit in the timebank. You can set a maximum in the CONFIG.EXE program. Optional data: None Type.........: 73 Description..: Deposit time in timebank Allows the user to store time in the timebank. Optional data: None Type.........: 74 Description..: Withdraw time from timebank Allows the user to withdraw time from his/her account. Optional data: None Type.........: 75 Description..: User online / Other line status Show's who is on the other line(s) or the cur- rent status of the other line(s). Optional data: None </S> If you leave the optional data field empty, SuperBBS will show the user who is on the other line(s). If you use the /S parameter, SuperBBS will show you the status of the other line(s). Type.........: 76 Description..: Send message to other user on-line Allows the user on a line to send a on-line message to a user on another line. This only works if the 'Do not disturb' flag is not on. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 111 Type.........: 77 Description..: Change current language Allows the user to change his/her current lan- guage file. (If you run with more than one language file.) Optional data: None Type.........: 78 Description..: Toggle 'Do not disturb' on/off Allows the user to toggle the 'Do not disturb' flag on and off. This way he/she can prevent receiving messages from other line users. Optional data: None Type.........: 79 Description..: Toggle full-screen message viewer on/off Allows the user to toggle in SuperBBS the full- screen message reader on or off. Quotes are now written in a different colour when messages are viewed with the fullscreen message viewer. Optional data: None Type.........: 80 Description..: Displays mail areas with unread mail. All areas which contains mail not yet read by the user will be displayed. The menu option also tells the user how many messages are unread and if there are any personal unread messages. Optional data: None or /C The /C option works on the user selected com- bined boards (Message board 0). If you leave the optional data field empty, it works on all file areas. Type.........: 81 Description..: This menu option allows the user to scan a file for a virus infection. SuperBBS normally scans uploads for viruses (if enabled), but now the user can enter a filename of the file he/she wants to scan. You will need the known ar- chivers and the SCAN virusscanner somewhere in your path. Optional data: /F or Full path Type.........: 82 Description..: Allows the user to download the messages in the QWK format, so he/she is able to read them offline at his/her own pace. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 112 Type.........: 83 Description..: Upload option for replies on the QWK messages downloaded with the menu option 82. The upload is done in a .REP file, which SuperBBS will extract and than place the messages contained in the .REP file in the correct areas, or the default QWK area. Optional data: None Type.........: 84 Description..: Allows the user to update his/her lastread pointer, telling SuperBBS where to start searching for new messages when downloading a QWK packet. Optional data: None Type.........: 85 Description..: Show an aphorism to the user. An aphorism, also called 'fortune cookie' is a little text which is funny or interesting or just a text. (Like the laws of Murphy.) SuperBBS will randomly display an aphorism from a file given in the optional data field. This file has to be in a certain format: ** Life is great if you run SuperBBS! By: Frank Hemmelder ** SuperBBS is now bugfree! By Aki Antman SYSTEM ERROR: Disconnecting ** Murphy says: Everything that can go wrong, will go wrong! ** The ** has to be the first two characters on the line. They separate the aphorisms from each other. The ANSI/ASCII file APHORISM.A?? is displayed before the aphorism itself. You can use all control codes in the aphorism file, like all colour codes and other options. Optional data: Drive:\Fullpath\Filename.ext -------------------------------------------------------------- SuperBBS v1.15 documentation Page 113 Type.........: 86 Description..: Execute the doornumber in the optional data field or the current door in the configuration program. Optional data: Doornumber or /D When using the door template menu, use the /D option to execute the door. When you want to start a specific door, use the doornumber as setup in the configuration menu. SuperBBS will save the door information, so the user will be returned to the same door the next time he chooses the door menu. Type.........: 87 Description..: Select a door from the list. Use this command when working with the door template menu as set in the configuration. This option will display a list of all available (to the user) doors. If his/her security is too low, or the user doesn't have the correct flagsetting for a door, this door won't be displayed in the list. Optional data: None Type.........: 88 Description..: Browse the nodelist menu option. this allows you and your users to search through the node- lists, when compiled, for a certain address. You will have to compile the nodelist with the SBBSNODE.EXE program. (See the chapter on util- ities.) Optional data: None Type.........: 89 Description..: This menu command is an area by area read com- mand. You can read all unread messages in all areas after each other. If there are no new messages, SuperBBS will search for the next area with new messages. You can always stop reading after a message by pressing the corre- sponding key for the Stop command. There is also a command available to go to the next area. Only the areas selected with the combined area select are used for this methode of reading the messages. Optional data: None -------------------------------------------------------------- SuperBBS v1.15 documentation Page 114 Type.........: 90 Description..: Attach a file to another user. This way a user can send a file to another user. If local, the file will be copied to the correct place, after SuperBBS prompts for the filename. When used remote, the user can upload the file by using any protocol. This menu option allows the transfer of the files privately. SuperBBS will store the files in the Local Attach area, set in the configuration program. (The LA directory in the directory configuration.) Optional data: None or message area number When using the optional message area number, the user can leave a message to the receiver of the file, telling him/her about the file. If no optional area number is used, there is no mess- age attach option for the user. Type.........: 91 Description..: Check if the current user has some attached files waiting. If there are files waiting, the user will be told so and given the option to download them. You can enable/disable the check on local attach files from the configuration program. Optional data: None Type.........: 92 Description..: Select the archiver the user wants to use to archive the .QWK packet with. Used with menu option 82 and 83. Optional data: None That's it, all available menu commands. If you are convert- ing from RemoteAccess, Proboard or QuickBBS to SuperBBS remem- ber that there are different options available in SuperBBS, which the others do not have. Please check your configuration carefully if starting with SuperBBS. 5.3 Menu templating -------------------------------------------------------------- Maybe you remember the good old days. In those days you had to build a menu for every available message and file area. Those days are gone. Now there is menu templating. This means you have one menu for all your message areas, another for all your file areas and another for your doors. How does it work? First you design your menu. Then you enter all the needed information. But instead of entering messagebase numbers, you enter /M. SuperBBS will replace this with a message area number. The same for the file areas. Design your menu, enter -------------------------------------------------------------- SuperBBS v1.15 documentation Page 115 the /F instead of the directory. SuperBBS will replace it with the information given in the CONFIG.BBS program. When design- ing your menu for doors, use the /D option, instead of the doorname. Let's have a look at how to setup a message menu this way: First you have to get from your main menu to the message menu. We want to start in area 01. We use menu option 1 and the optional data field would be: MAIL /M. MAIL is the menu name, /M tells SuperBBS to go to the message area last visited by the user. If he/she never visited a the mail areas, he/she will be placed in the first area defined in CONFIG.EXE. If you want to go to the second area, you could also have said /M=2. Now we need the read, write, scan, quickscan and delete options. Set up the menu as you normally would, except instead of using the messagebase number, use the /M in the optional data field. SuperBBS will know in what area the user is. Even if the user goes to the main menu and then returns to the messagebase, he/she will still be in the area he/she left from, because SuperBBS keeps track of the users movement. You can use the /M (/F for fileareas and /D for doors) for changing the area. If you use a type 1 menu and as optional data field the menu name and /M=+1, SuperBBS will change to the next area. If you use in the optional data field the /M=-1, SuperBBS will change area to the previous area. This option is endless, because the user is placed back to the first area when he/she wants to go to the next area from the last area. It looks like this: ---> 1 --> 2 --> 3 --> 4 --> 5 --> 6 --> 7 --- | | ---------------------------------------------- In this example is area 1 the lowest and area 7 the highest. This also works the other way around. So in short: Menu type 1 - MenuName /M = Goto message area Menu type 2 - MenuName /F=31 = Gosub file area 31 Menu type 23 - /M = Read messages in current area Menu type 32 - /F = Download from current area Menu type 1 - MenuName /M=+1 = Goto next message area Menu type 1 - Menuname /F=-1 = Goto previous file area Menu type 1 - MenuName /D = Goto door menu Menu type 1 - MenuName /D=+1 = Goto next door menu Menu type 86 - /D = Run current door -------------------------------------------------------------- SuperBBS v1.15 documentation Page 116 To show the name and number of the area you are currently in use these codes: <Ctrl-K>4 = File area name in ANS/ASC files <Ctrl-K>5 = Message area name in ANS/ASC files <Ctrl-K>" = Number of current message template area <Ctrl-K># = Number of current file template area <Ctrl-K>& = Name of current door <Ctrl-K>/ = Number of current door @ (Ascii 64) = File area name in menu textline ' (Ascii 96) = Message area name in menu textline These codes are replaced with the name you have set up in the CONFIG.EXE program. If you use characters behind these codes, please think about the fact that the codes will be replaced by the area name, so you might have to check if your menu is still aligned the way you want it. Example: In your menu: Area ^K#: @ SuperBBS HQ For the user: Area 12: General area SuperBBS HQ In this example the user is in file area 12, General area. Note that the control code should be entered by holding down the Control key and pressing the K key. The # is a normal character which should be entered without the control key being pressed. SuperBBS saves the template information, so the user will be put in the same template menu he/she was last in when calling the next time. 5.4 Changing hardcoded menu options -------------------------------------------------------------- SuperBBS has the option to allow the use of your own commands, instead of the hardcoded menus in SuperBBS. These options can be used for these menu commands: 23 Read messages 24 Scan messages 25 Quickscan messages These are the available commands to replace the hardcoded box in SuperBBS. You need to set these options in the optional data field, when editing a menu. /F Read messages in forward order /R Read messages in reverse order /I Read individual messages /N Read new messages /S Read selected messages /M Read marked messages /O Read n number of messages -------------------------------------------------------------- SuperBBS v1.15 documentation Page 117 These options are also available in template menus, so you're able to build a very powerful (and in your own language if needed) message menu. Here is an example of a menu. The first /M is from the message area the second '/' option is to replace the hardcoded menu. Menu Opt. data Menu textline ---- -------- ---------------------------------------------- 23 /M /F Read messages in forward order in current area 23 /M /M Read marked messages in current area 24 8 /S Read selected messages in area 8 25 /M /N Quickscan new messages in current area 27 /M Write a new message in current area 68 Choose other area from area list And your imagination can do the rest. It is just an example, so don't use it as a complete menu! 5.5 INCLUDE1.MNU -------------------------------------------------------------- This is a very special menu file. This menu allows up to 10 commands to be entered, which then will be added to all your existing menus. If SuperBBS finds this file in your menu directory, all menu commands are available to the user at any menu in your BBS. Very useful for the logoff command, paging the Sysop, help and what you can think of. Design the menu as you normally would design a menu. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 118 Chapter 6 Control codes ============================================================== 6.1 Control codes in menu and textfiles -------------------------------------------------------------- You can now use several control codes in your menu. They don't have to be displayed through an ANSI or ASCII file, but can be used on the menu textline itself. Here's a complete list of all the control codes you can use, either in an ANSI or ASCII file or in your menu textline: (^ = Ctrl key) ASCII Char. Function description --------- -------- ----------------------------------------- 1 ^A Wait for ENTER key to be pressed 2 ^B Turns OFF aborting with S key 3 ^C Turns ON aborting with S key 4 ^D Turns ON the 'More' prompt 5 ^E Turns OFF the 'More' prompt 6 ^F Not used alone (See below) 7 ^G Generates a 'BEEP' 8 ^H Backspace 9 ^I Tabulator 10 ^J Linefeed 11 ^K Not used alone (See below) 12 ^L Clears screen 13 ^M Carriage return 6.2 ^F codes -------------------------------------------------------------- The ^F codes available: (All codes apply to current user!) ASCII Char. Function description --------- -------- ----------------------------------------- 6 65 ^FA User's full name 6 66 ^FB User's city and state 6 67 ^FC User's password (Use with care!) 6 68 ^FD User's business/data phone number 6 69 ^FE User's home/voice phone number 6 70 ^FF User's last calling date 6 71 ^FG User's last calling time (24 hrs format) 6 72 ^FH User's A flagsetting 6 73 ^FI User's B flagsetting 6 74 ^FJ User's C flagsetting 6 75 ^FK User's D flagsetting 6 76 ^FL User's netmail credit 6 77 ^FM Number of messages user has written 6 78 ^FN Highest message number user has read 6 79 ^FO User's security level 6 80 ^FP User's number of calls -------------------------------------------------------------- SuperBBS v1.15 documentation Page 119 6 81 ^FQ User's uploads in files 6 82 ^FR User's uploads in KBytes 6 83 ^FS User's downloads in files 6 84 ^FT User's downloads in KBytes 6 85 ^FU Elapsed time this call in minutes 6 86 ^FV User's screen length 6 87 ^FW User's firstname 6 88 ^FX Status ANSI graphics (ON/OFF) 6 89 ^FY Status More prompt (ON/OFF) 6 90 ^FZ Status CLS codes (ON/OFF) 6 48 ^F0 User's Sysop comment 6 49 ^F1 Status Full Screen editor (ON/OFF) 6 50 ^F2 User's age 6 51 ^F3 User's birthday 6 52 ^F4 User's time of first call (24 hrs format) 6 53 ^F5 User's date of first call 6 54 ^F6 Status of mailcheck at logon (ON/OFF) 6 55 ^F7 User's up/download ratio in KBytes 6 56 ^F8 User's up/download ratio in files 6 57 ^F9 Status new files check at logon (ON/OFF) 6 33 ^F! Total minutes used 6 34 ^F" Status full screen reader 6 35 ^F# Expiration date 6 36 ^F$ Expiration days left 6.3 ^K codes -------------------------------------------------------------- The ^K codes available: ASCII Char. Function description --------- -------- ----------------------------------------- 11 65 ^KA Total number of calls to system 11 66 ^KB Name of the last caller 11 67 ^KC Number of active messages on system 11 68 ^KD Number of lowest message on system 11 69 ^KE Number of highest message on system 11 70 ^KF Number of times user has yelled SysOp 11 71 ^KG Day of the week in full 11 72 ^KH Number of users on system 11 73 ^KI Current time (24 hrs format) 11 74 ^KJ Current date (DD-MM-YY) 11 75 ^KK Number of minutes connected this call 11 76 ^KL Number of seconds connected this call 11 77 ^KM Number of minutes used against time limit 11 78 ^KN Number of seconds used against time limit 11 79 ^KO Number of minutes remaining this call 11 80 ^KP Number of seconds remaining this call 11 81 ^KQ Time Limit this call (Minutes) 11 82 ^KR User's baud rate (300-38400) 11 83 ^KS Abbreviated day of week 11 84 ^KT Download Limit in KBytes 11 85 ^KU Number of minutes until next system event -------------------------------------------------------------- SuperBBS v1.15 documentation Page 120 ASCII Char. Function description --------- -------- ----------------------------------------- 11 86 ^KV Time of next system event (24 hrs format) 11 89 ^KY User's maximum up/download ratio in KBytes 11 90 ^KZ User's maximum up/download ratio in files 11 48 ^K0 Current language file description 11 49 ^K1 Status of scroll lock 11 50 ^K2 One second pause 11 51 ^K3 Display securitylevel comment (LIMITS.BBS) 11 52 ^K4 Name of the current filearea 11 53 ^K5 Name of the current messagearea 11 54 ^K6 User's alias 11 55 ^K7 User's time in bank 11 56 ^K8 User's number of calls today 11 57 ^K9 Number of messages in current area 11 33 ^K! Status of do not disturb flag (ON/OFF) 11 46 ^K. Number of current node 11 34 ^K" Number of current message template area 11 35 ^K# Number of current file template area 11 37 ^K% User's download remaining today in KBytes 11 38 ^K& Name of the current door 11 47 ^K/ Number of the current door Do not use the ^Q, ^S and ^Z commands, because these are dangerous and can give you unexpected problems. To enter a code in your textfiles, use the Ctrl-F command. This means, press the control key, hold down while pressing the mentioned key (in this example the F), release and press the second character (in case of the ^F and ^K keys.) Another way is holding down the ALT key and pressing the ASCII value from the numeric keypad on the right of the keyboard. This only works on EXTENDED keyboards!! 6.4 ^X, ^C, ^P and ^A keys -------------------------------------------------------------- There are four special control keys available. These have special functions in SuperBBS or the external utilities. The ^X key is used to run a program from an ANSI or ASCII file. If superBBS comes across an ^X code while displaying a file, it will execute the program behind the ^X code. For an example: ^XMYPROG.EXE This will start the MYPROG.EXE program when the file is dis- played where this code is in. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 121 The ^C, ^P and ^A key are used in the LCONFIG program and menu editor. The ^C code is used for changing colour in the text- lines in LCONFIG.EXE. (See the language configuration part of the docs for more info.) The ^A executes a display of a file in the language files. You can use this command to display an ANSI/ASCII file, instead of the normal textline. ^AHELP will display the file HELP.A?? from the textfile directory. The ^P key is used to enter another control code in the menu and/or textlines. You have to press ^P first, before you can enter a control code in a textline or menuline. 6.5 ^O control codes -------------------------------------------------------------- With the release of the 1.15 version of SuperBBS, a new set of control codes have been added to the program. These codes are accessed through the ^O key. You can use the ^O key to display the flagsettings of the user. Here's the commandline: ^O<Flag><Flag number> This will display the current user's flagsetting, either On or Off. For example ^OA5 will display the setting of flag A, number 5. With this option you can display all 32 flags. 6.6 Additional control codes -------------------------------------------------------------- Some additional control keys can be used within the message- base from SuperBBS. These codes are: @1 User's name @2 User's City & State @3 User's security level @4 User's birthday @5 User's age @6 User's firstname These codes can be used, if you did allow them to be used in CONFIG.EXE, in messages written in SuperBBS. The following additional control keys are needed for setting up a multiline system with template menus. These codes can be used in the data fields of the menus. The codes are: @N Number of the node the user is on @M Number of current message template area @F Number of current file template area @S User's security level @D Number of the current template door -------------------------------------------------------------- SuperBBS v1.15 documentation Page 122 These codes allow you to use the temporarily areas in a multi- line system. For example, name your temporarily directories TEMP1 and TEMP2, for line 1 and 2, and specify the optional data field with TEMP@N, which will be replaced by TEMP1 or TEMP2 depending on the node the user is on. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 123 Chapter 7. Message base ============================================================== 7.1 General information -------------------------------------------------------------- The SuperBBS message base is fully compatible with QuickBBS and RemoteAccess. This will not guarantee that this will stay this way in the future. Either SuperBBS or the other programs might come up with a better type of message base. Currently you can use your old messagebase when converting from RA and QuickBBS to SuperBBS. You should set up the location of your messagebase in the CONFIG.EXE program. User's (and Sysop) are able to read, write, scan, quickscan and delete messages. The messages are numbered in increasing order. The first message starts at one, the second at two and so on. This doesn't mean both messages are in the same area. Besides the message number, SuperBBS also keeps track in which area the message belongs. When reading messages, you will see a notice stating that there are xxxx messages active. And that the lowest message is numbered yyyy and the highest zzzz. Also stated is the amount of messages in the current area. It looks something like this: Active msgs: 1234. Lowest message: 1. Highest message: 23460 Number of messages in this area: 25. This means that from the 1234 messages, which starts at 1 and ends at 23460, there are 25 messages in the current area. SuperBBS now also supports real message numbering in an area. Every message area will be numbered from 1 to xx. This only applies to the user reading mail. Internally SuperBBS still uses the normal message numbering as described above. If you use this option of real message numbering, which we strongly suggest cause it is easier for your users to keep track of numbers while reading messages, you will have to change a line in the language file. This is the line stating the amount of messages in the messagebase. This has to be changed to the amount of messages per area. See the Lconfig part for more information. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 124 7.2 Sysop keys available -------------------------------------------------------------- The following options are available to the Sysop when reading messages: <A>gain Show current message again. <N>ext Show next message <B>ack Show previous message <J>ump Jump to specified message <R>eply Reply to the current message <W>rite Write a message in current area <D>elete Remove the current message <K>eep as unread Toggle the read/unread flag on/off <X>port Send message to printer or file <C>opy Copy current message to another user/board <E>dit Edit the message information, like: 1. From Who wrote the message 2. To To whom message is send 3. Subject Subject of the message 4. Board Area number where msg is 5. Quit Abort editing 6. Save Save message <=>Private Toggle the private/public flag on/off <S>top Stop reading messages Use the <E>dit command and option 4 if you want to copy a message to another area. Use the <C>opy command if you want to forward a message to another user or system. One undocumented option is available to Sysops when reading ECHO and NET mail, the <!>. This allows you to see the infor- mation normally hidden in a message through a Ctrl-A code. Information like path and kludges are normally hidden behind these codes. Note that the keywords shown here can be altered through the lconfig.exe program. 7.3 QWK offline mail system -------------------------------------------------------------- SuperBBS is one of the first bulletin boards to support QWK packets directly. QWK is a mailreader system. this means the user downloads the messages and instead of reading them on- line, he/she can read them offline, saving a lot of money. Here's how it works. A user calls in on your board. he/she goes to the QWK menu options and selects the download command (menu option 82). First SuperBBS will ask the user if he/she wants to download the messages in QWK or ASCII format. (Most will choose QWK, sine it makes smaller packets.) Than SuperBBS will scan -------------------------------------------------------------- SuperBBS v1.15 documentation Page 125 through the message areas for any unread mail in the areas the user selected. If there is new mail, SuperBBS will export the messages and put them in an archive. This user can download this archive. Offline, the user goes into the mail reader, for example the Silly Little Mail Reader (TM) or the XRS reader (TM), which now also supports the QWK packets. He/she than reads the messages, write replies or/and new messages and on the next call uploads these messages with the upload command (menu option 83). Besides the mail package, your WELCOME.A?? and GOODBYE.A?? are packed in the archive. The same accounts for your NEWS.A?? file, if available. These will be displayed while reading the messages with the SLMR program. SuperBBS will place the QWK packets in the WORK directory, as specified in your path settings in the configuration menu. Packets are deleted after the user has downloaded them. To separate your packets from those from other Bulletin board systems, you have to give the QWK packet an unique name. (Also done in the configuration program.) The reply packets will have the same name, except for the extension, which will be .REP, instead of the .QWK for the mailpacket. With menu option 84 is the user able to select where SuperBBS will start searching for new messages. This menu option allows to change the lastreadpointer of the user. Taglines can be allowed on your system. A tagline is a little line below the message with a witty or funny textline. Not all echomail areas allow the use of the tagline, because echomail already adds an origin line to the message, giving it a double originline, when a tagline is also added. That's why you can set it to Always allow taglines, never allow taglines or just allow them in local areas. Selecting the areas you want the mail from is done through the use of the area select command for message area 0, the global message area. (Menu option 28.) Areas which are set to On will be used to export the mail from. Areas set to Off will not be scanned for mail. It is useful to put this menu option in your QWK menu screen. QWK support is not 100% yet in this version of SuperBBS, but it will be in the near future. It is however ready enough to be used by your users. Support the offline mail reader and get your users to use it. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 126 7.4 Group messages -------------------------------------------------------------- A very powerful way to send a message to every user or just a certain security level is the Group message function. If enabled, every user who logs on to your system will get the message as if it is addressed to him/her personally. You have to address the message to: *everyone*. In this case everybody will receive the message. If posted to a certain security number, like *everyone*100, only users with security level 100 will receive the message. Post a group message always as a private message, otherwise all users can read the message. There are two new options available with menu option 22 (mail check), these options are: /A Display all messages (New normal messages and new group messages). /G Display only new group messages. This message system could be used for informing your users about certain things happening on your BBS or any other infor- mation. You will have to set the security level needed to post group messages in the configuration program. This means you can also let your users send group messages. 7.5 Netmail -------------------------------------------------------------- SuperBBS is a fidonet compatible BBS program. This means you can exchange messages with other systems. These messages can be NETMAIL or ECHOMAIL. SuperBBS does use a nodelist, but you will still need a mailer who will handle the sending of the netmail, for example Front- door (TM) or D'Bridge (TM). If you have setup a netmail directory, SuperBBS will ask you for the address the message has to be send to. Here you have to enter a valid fidonet address. If you don't know the address, you can browse through the nodelist and search for the node you want. If your replying to a message, SuperBBS will try to match the senders zone, if you have an AKA in the senders network. If SuperBBS can't match the senders zone, he will use the main address. After you supplied the destination address, SuperBBS will ask you if the message is a CRASH (or send immediately) message. Third and last question is about File attachments. You can send a file to another BBS this way. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 127 If you say YES to the previous question, SuperBBS will ask you for the filename. Then you can enter your message. Contact a BBS system running Netmail if you want more information on this subject. See the external utilities for more info on the SBBSNODE.EXE program. SuperBBS now also supports Point addresses, even if there is no nodelist available. 7.6 Echomail -------------------------------------------------------------- Echomail is mail that is distributed every night over several BBS systems. This means your message could get all over the world, depending on the area your in. This also is the most expensive form of mail. A message written on your system can be read on hundreds of other systems. All messages are always public. You can setup every message area in SuperBBS for echomail use. You can select a different AKA address (if you have them) and choose an origin line for every area (through ECHOORIG.CTL). You will need a front end program (also called mailer) to run Echomail. To run echomail you need an echomail processor. These will unpack messages from the archives they are send in and toss them to your echomail area. They also pack new messages from your system and prepare them to be transferred. Some processors are: (Copyrighted by their owners) - ZmailH Echo & Netmail scanner/tosser - TosScan Echo & Netmail scanner/tosser - Imail Echo & Netmail scanner/tosser - GEcho Echomail processor There are more programs available. Ask for them at a BBS near you, running echomail. The D'Bridge mailer has net and echo- mail support build into the program and support SuperBBS. You will also need some echomail utility program. This program must be capable of linking messages, renumbering and deleting them. One of the best programs around is MBUTIL (TM) written by Gerard van der Land. This program can take care of all your echomail area maintenance and more. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 128 7.7 Nodelist support -------------------------------------------------------------- SuperBBS has a limited Nodelist support build in. Limited because the cost support is not yet available. SuperBBS uses the QuickBBS alike indexfiles. These are created with the SBBSNODE.EXE program. Their is a menu option available to browse through the nodelist. When entering echomail, you have the option to scan through the nodelist to find the address. SuperBBS support point addresses. If no nodelist is available, SuperBBS will still work and you can still sent netmail. Also point addresses are still sup- ported. 7.8 Search userlist -------------------------------------------------------------- When enabled in the configuration program, SuperBBS allows the user who entered a non-existing name in a local message area to scan through the userlist. You can toggle this function on and off in the configuration program. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 129 Chapter 8. Files base ============================================================== 8.1 General information -------------------------------------------------------------- The filebase is just like SuperBBS messagebase compatible with RemoteAccess and QuickBBS. SuperBBS uses a FILES.BBS file to display the available files to the users. This file looks like this when viewed with a normal ASCII editor: Filename Description ^---- Cursor position 14 SuperBBS will add the information like size and date if the file is found in the current area. If not, the word defined in the lconfig program for the word offline will be displayed instead of the date and size. The description has to start on character number 14. SuperBBS allows you to have more then one file description line. You can set this information in the CONFIG.EXE program. If you want to add a line with a text editor, use one who ends without putting a Ctrl-Z at the end of the document, start the extra description line with the ' >'(ASCII 32+62) sign. This will tell SuperBBS it is a file description line and will display it at the right place. (See the eaxmple in the part of this chapter concerning the up- loader name.) SuperBBS now also wraps the text around if the textline is longer than 45 characters. The wrapped text will be displayed at the right indent. You can set this in the configuration program. 8.2 Extract and view option -------------------------------------------------------------- SuperBBS allows you and your users to extract, view and repack a file while on-line. SuperBBS has support for ZIP, LZH, PAK, ARJ and ARC files. You can extract a file, view the contents of the file, read textfiles from within the file and repack only the wanted files, while discarding the rest. SuperBBS makes use for this option of the TEMP directory which you have to set up in CONFIG.EXE. After use, SuperBBS will clean the area in case the user doesn't and you have set the option on in CONFIG.EXE. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 130 8.3 Uploader to files.bbs -------------------------------------------------------------- SuperBBS allows you to optional put the username of the upload in the files list. This only works if you have the use of the '>' character in the files base listing set to on. SuperBBS will put the name of the uploader as the last line of the description. It will look like this: SBBS_115.ZIP 532267 15-jan-91 New SuperBBS release v1.15 Full featured version. Uploader: Aki Antman This is what your users will see. In your files.bbs list it will look something like this: SBBS_115.ZIP New SuperBBS release v1.15 >Full featured version. >Uploader: Aki Antman Some Sysops use this method to give you some more system security, because everybody can see which file is uploaded by whom, preventing them to send you trojanhorses or virusfiles. 8.4 FILES.CTL -------------------------------------------------------------- This file, which is a plain ASCII file, gives you control over the files in your filebase. It is possible to assign passwords to files, specify unwanted files and allow free files. Use this file as follows: <Filename> /FREE <Filename> /UNWANTED <Filename> /PWD=<password> You can use wildcards in the filenames. If you don't specify a directory, the option will work in all file areas. Here's an example: SBBS_111.ZIP /FREE BETA_112.ZIP /PWD=BETATEST /FREE *.GIF /UNWANTED C:\TMP\ZIP.ZIP /FREE This will make the SBBS file free, protect the free file Beta with a password, tells users .GIF files are not welcome and makes the ZIP.ZIP in the TMP directory also free. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 131 8.5 New list option /N -------------------------------------------------------------- The list option (menutype 31) of the Files.bbs file has been expanded. Besides the file format you want to look at, with all wildcharacters available, the user now also has the option to look only at the newfiles in the list. This is done by the /N option, after the user pressed the character to list the files. SuperBBS will display the question about the file mask. At this point entering /N will only display the newfiles. Make sure you change your textline in Lconfig.exe to incorporate this new option. 8.6 Download counter -------------------------------------------------------------- SuperBBS has a build in download counter. This allows you to keep track of the number of downloads for each file. In the configuration program you will have to specify which charac- ters you want to use as brackets. (For example: [], () or <>) SuperBBS will keep track of the downloads and everytime a file is downloaded will update the counter. If no counter is avail- able, SuperBBS will add one. This makes your files.bbs file look like this (Using [] as brackets): SBBS_115.ZIP 532267 15-jan-91 [17] SuperBBS version 1.15 Full featured version Uploader: Aki Antman SDOC_115.ZIP 100001 15-jan-91 [2] SuperBBS documentation Uploader: Frank Hemmelder SUPERNET.A68 32180 15-jan-91 New SuperNet nodelist Uploader: Robbert Roos Please note that SuperBBS does not currently fill out the counter when below the 10. This might be available in a later version. Also files not downloaded won't have a counter set to zero. When you set the brackets option in the configuration program to spaces, the downloadcounter will be disabled. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 132 Chapter 9. Support files ============================================================== 9.1 General information -------------------------------------------------------------- SuperBBS uses a whole range of extra ANSI and ASCII support files. You can define these files yourself, or use the build in (English) messages. This way you can personalize your system. If a file is not available, SuperBBS will display a message of it's own, if needed. You can make these ANSI and ASCII files with a program like Thedraw. It even allows you to use animation in your ANSI files. Do remember that users are calling in and that a long screen build up will scare them away, or they switch to ASCII. SuperBBS will first look for the files in the ANSI/ASCII textfile directory specified in the language files, then in the text directory specified in the CONFIG.EXE program and if still no file is found, it will display the message of it's own, which is normally just a textline explaining what is going on. 9.2 ANSI and ASCII Support files -------------------------------------------------------------- These are the support files: Name.........: 0001 (0102, 0203......2223, 2324) Type.........: ANS/ASC Description..: File to be displayed at logon, between 00:00 and 01:00 hrs. This way you can setup a file for every hour. 1516.ANS would be displayed between 15:00 and 16:00 hrs. Name.........: ALIASASK Type.........: ANS/ASC Description..: This file is displayed at logon of a newuser just before asking the alias he/she wants to use. This file should contain some information about the use of an alias on your board. Name.........: APHORISM Type.........: ANS/ASC Description..: Shown to the user before the aphorism (menu option 85) is shown to the user. Name.........: BADALIAS Type.........: ANS/ASC Description..: Shown to the user when the alias the user wants to use is found in the BASALIAS.CTL file. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 133 Name.........: BIRTHDAY Type.........: ANS/ASC Description..: Shown when a user calls on his/her birthday. Name.........: BVERIFY Type.........: ANS/ASC Description..: Shown to the user when he/she is asked to give his/her birthday as part of the system security check. Name.........: DNLDHRS Type.........: ANS/ASC Description..: Shown to a user who wants to download when downloading is not allowed as specified in CONFIG.EXE. Name.........: DPHONE Type.........: ANS/ASC Description..: Shown to the user when he/she enters a dupe phonenumber and the configuration has been set to disconnect the user after showing this file. Name.........: EDITHELP Type.........: ANS/ASC Description..: Shown to the user when he/she asks for help within the message editor. Name.........: FGOODBYE Type.........: ANS/ASC Description..: Shown to the user when he/she decided to logoff after a file transfer. Do not use the code Ctrl-A (= Press return) in this screen, other- wise the user can't use the automatic logoff, because SuperBBS will wait for the return. Name.........: GOODBYE Type.........: ANS/ASC Description..: Shown to the user at logoff, just before the modems disconnect. Name.........: LOGO Type.........: ANS/ASC Description..: Shown to the user before asking the user's name at logon to your system. At this moment is SuperBBS not aware which language a user is using, so it uses the directory specified in the first language file in LANGUAGE.CTL. If you are using different languages, this file should contain all available languages. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 134 Name.........: LOGONAGE Type.........: ANS/ASC Description..: Shown to the user when he/she is too young to logon to your system, as set in the configur- ation program. Name.........: LOGONPWD Type.........: ANS\ASC Description..: Shown to the user when he/she gives the wrong password for loging on to your system, when you have specified a global password in the con- figuration program. Name.........: LOGONSEC Type.........: ANS/ASC Description..: Shown to the user when his/her security level is not high enough to logon to your system, as specified in the configuration program. Name.........: MAXPAGE Type.........: ANS/ASC Description..: Shown to the user when trying to page the Sysop more times then specified in CONFIG.EXE. Name.........: NEWS Type.........: ANS/ASC Description..: File displayed to every user at logon. Useful for newsflashes. Programs like NEWS_140.xxx are easy for creating and editing this file. Name.........: NEWUSER1 Type.........: ANS/ASC Description..: Shown to newusers after he/she has verified his/her name and before the other logon ques- tions are asked. At this point does SuperBBS not know which language the user wants to use, so you should make this file contain all avail- able languages. Name.........: NEWUSER2 Type.........: ANS/ASC Description..: File displayed to a new user after he/she answered the questions about system options and selected a password, but before the NEWUSER.Q-A questionnaire is answered. Name.........: NO300 Type.........: ANS/ASC Description..: Shown to the user trying to logon to your BBS at 300 Baud when this is not allowed as you specified in the CONFIG.EXE file. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 135 Name.........: NOPAGE Type.........: ANS/ASC Description..: Shown to the user when you are paged, but you disabled yell with the Scroll-lock key. Name.........: NOTAVAIL Type.........: ANS/ASC Description..: Shown to the user when you are paged outside yelling hours. Name.........: NOTFOUND Type.........: ANS/ASC Description..: Shown to the user if the system can't find the user's name in the user list. At this moment is SuperBBS not aware of the language the user is using or want to use. This file should there- fore contain all available languages. Name.........: PAGEABRT Type.........: ANS/ASC Description..: Shown to the user when the Sysop aborts the yell from the user. Name.........: PAGED Type.........: ANS/ASC Description..: Shown to the user after a yell for the Sysop, incase the Sysop didn't answer. Name.........: PAGEQUES Type.........: ANS/ASC Description..: Shown to the user when yelling the Sysop, just before the user is asked for the reason of the page. Name.........: PASSWORD Type.........: ANS/ASC Description..: Shown to the new user just before the system asks for a password, or just before the user has the option to change his/her password. Name.........: PRIVATE Type.........: ANS/ASC Description..: Shown to the user if your system is a private system and a non-registered user is trying to get in. The user will be disconnected after displaying the file. Name.........: RATIO Type.........: ANS/ASC Description..: Shown to the user when the upload/download file ratio is exceeded as configured in CONFIG.EXE. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 136 Name.........: RATIOK Type.........: ANS/ASC Description..: Shown to the user when the upload/download kbytes ratio is exceeded as configured in CONFIG.EXE. Name.........: READHELP Type.........: ANS/ASC Description..: Shown to the user if he/she asks for help with the read, scan and quickscan commands. Name.........: SECxxxxx Type.........: ANS/ASC Description..: Shown to the user just after the welcome screen if he/she has the security level 'xxxxx'. 'xxxxx' has to be a value between 0 and 32000. (SEC20.ANS will be shown to security level 20 user's.) If this file is not found, SuperBBS will look for a SECALL.A?? file. Name.........: SECALL Type.........: ANS/ASC Description..: Shown to the user if for his/her security level no SECxxxxx.A?? file is available. Name.........: TIMEWARN Type.........: ANS/ASC Description..: Shown to the user when his/her time is adjusted due to an upcoming event. Name.........: TOOSLOW Type.........: ANS/ASC Description..: Shown to the user when trying to logon to the system at a bps rate which is not fast enough, as configured in CONFIG.EXE. Name.........: TRASHCAN Type.........: ANS/ASC Description..: Shown to the user when his/her name was found in the TRASHCAN.CTL list. The user will be disconnected after displaying the file. Name.........: VIP Type.........: ANS/ASC Description..: Shown to the user after the welcome screen if his/her name was found in the VIP.CTL list. Name.........: WELCOME Type.........: ANS/ASC Description..: Shown to the user after he/she entered her name and password. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 137 Name.........: WELCOME1 Type.........: ANS/ASC Description..: Shown just after the welcome screen. Name.........: XFERHELP Type.........: ANS/ASC Description..: Shown to the user when the user asks for help with the transfer protocols and file transfer. 9.3 .CTL, .LNG and .BBS Support files -------------------------------------------------------------- Besides the ANSI and ASCII files, SuperBBS uses a couple of .CTL, .LNG and .BBS files to control his behaviour. The .CTL files are all plain ASCII files and can be edited with every normal texteditor, even Edlin if you like. The .BBS files are all controlled through the CONFIG.EXE program. The .LNG files are language files and are controlled through the LCONFIG.EXE program. The .BBS and .LNG files are mentioned here as refer- ence, so you know what every file is for. Their set up is explained in detail in chapter 3. Type.........: *.LNG Description..: Language support files. Type.........: AREAS.BBS Description..: Not a file needed for SuperBBS, but most echomail processors need this file, that's why we mention it. It contains information about your message areas and who to send them to. The format is as follows: <Area Nr.> <Description_of_area> <Destination> Don't use the first three lines of the file. Just put a ';' in there. This is just a plain ASCII file. Type.........: BADALIAS.CTL Description..: Contains names which you as Sysop don't want to be used as aliases on your system. The format of this ASCII file is: Bad alias Bad alias Bad alias You can make this file with every normal ASCII text editor. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 138 Type.........: COMBINED.BBS Description..: Contains information about the user's settings for the combined message board (Area 0). There should be no reason to delete this file. Type.........: CONFIG.BBS Description..: Contains the complete setup from your system. This file should never be deleted, because you will have to setup your system again. This file is 100% QuickBBS compatible. Type.........: DOORS.BBS Description..: Configuration file for the doors you have set up in the configuration program. Type.........: DORINFO1.DEF Description..: One of two files, the other is the EXITINFO.BBS file, which contains information to be used by programs running outside SuperBBS. These files are generated when you do a type 7 or 15 exit. Type.........: ECHOORIG.CTL Description..: Plain ASCII file. With this file it is possible to have a different origin line in every mail area. The format of the file is as follows: <AreaNr.> <Origin line> <AreaNr.> <Origin line> Place this file in your main system area. Type.........: EXITINFO.BBS Description..: One of two files, the other is the DORINFO1.DEF file, which contains information to be used by programs running outside SuperBBS. These files are generated when you do a type 7 or 15 exit. Type.........: FILES.CTL Description..: This file, which is a plain ASCII file, gives you control over the files in your filebase. It is possible to assign passwords to files, spec- ily unwanted files and give free files. Use this file as follows: <Filename> /FREE <Filename> /UNWANTED <Filename> /PWD=<password> -------------------------------------------------------------- SuperBBS v1.15 documentation Page 139 You can use wildcards in the filenames. If you don't specify a directory, the option will work in all file areas. Here's an example: SBBS_111.ZIP /FREE BETA_112.ZIP /PWD=BETATEST /FREE *.GIF /UNWANTED C:\TMP\ZIP.ZIP /FREE This will make the SBBS file free, protect the free file Beta with a password, tells users .GIF files are not welcome and makes the ZIP.ZIP in the TMP directory also free. Type.........: FLSEARCH.BBS Description..: Contains all information about your file areas. Location, securitylevels, flagsettings, age to have access and if in the menu templating is stored in this file. Type.........: LASTREAD.BBS Description..: Contains information about every user and his/her lastread message number. Never delete this file, because all message will be displayed as new messages to the user's. Type.........: LIMITS.BBS Description..: Contains the information about userlevels and their limits. SuperBBS checks this file to find the information about the userlevels. Type.........: MSGIDX.BBS / MSGINFO.BBS / MSGTOIDX.BBS / MSGHDR.BBS / MSGTXT.BBS Description..: Contains the information about the messages on your system. If you want to start with a new and empty database, delete these files. Type.........: NODEIDX.SBS / NODEINC.SBS Description..: The two index files generated by the SBBSNODE.EXE program from the raw nodelist. These two files are needed if you use the node- list support in SuperBBS. Type.........: PFILES.BBS Description..: Contains information about private uploads done to you. This is a normal ASCII file. All pri- vate upload descriptions are stored in this file. Type.........: SLCALLER.BBS Description..: Contains information about the last 15 users to your BBS. You can delete this file if you want, but there should be no reason for it. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 140 Type.........: SPROTO.BBS Description..: Configuration file for the external protocols. Type.........: SUSERS.BBS Description..: Contains the extra user information like age, birthday, sex etc. Only delete this file if your userbase is messy and you want to clean it up. SuperBBS will ask every user for the needed information again. Type.........: TIMELOG.BBS Description..: Contains information about the usage of the BBS. The usage log is created out of this file. If you want to start all over with your usage log, delete this file. Type.........: TRASHCAN.CTL Description..: Contains user names you don't want to have on your board, like Sysop, Dr., Hacker etc. This is a plain ASCII file in the following format: User name User name User name Type.........: USERS.BBS Description..: Contains the information about the users. All normal user information is stored in this file. Only delete this file if you want to start with 0 user's. Backup this file often to prevent damage to your userfile if something happens. Type.........: VIP.CTL Description..: Contains information about special users to your BBS system. SuperBBS will show the file VIP.A?? to them at logon. This is a plain ASCII file with the following format: <User name> <User name> <User name> SuperBBS uses four logfiles for storing system information. One type you hopefully never have to see. These files are: Type.........: ERRORS.LOG & ERRORS.BBS Description..: Contains all errors which occur during oper- ation of SuperBBS. Please take note of these files and send the information to us, when you come across an error. Send this information to our support nodes or the SuperBBS HQ. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 141 Type.........: SBBSDOWN.LOG Description..: Contains all downloads done from your system and the names of the user who downloaded the file. Type.........: SBBSUP.LOG Description..: Contains all uploads done to your system and the name of the uploader. Type.........: SYSTEM.LOG Description..: Contains all information about what the user did on your system. Information like name, userlevel, alias, wrong passwords, exits to doors and time on-line are stored in here. This file is a plain ASCII file. If this file is missing, SuperBBS will create it the next time it is run, so you can delete this file as many times as you wish. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 142 Chapter 10. Questionnaire language ============================================================== 10.1 General information -------------------------------------------------------------- SuperBBS has a powerful questionnaire language available to the Sysop for designing question files. SuperBBS will run the questionnaire called NEWUSER.Q-A if a new user enters your system and the file is found. Answers will be stored under the same filename, but with the extension .ASW. All questionnaires have to have the extension .Q-A and all answer files will have the extension .ASW. You can design as many questionnaires as you like. You can run a questionnaire from a menutype 12. On the optional datafield, you have to supply the name of the questionnaire. 10.2 Available commands -------------------------------------------------------------- Here's a list of the available commands in the questionnaires: Used codes: <.......> = Mandatory [.......] = Optional Command.....: ASK <length> <variable> [default] Description.: Asks for a string from the user. Length defines the number of characters the answer can take, the variable is the answer number, which you can use in combination with other commands. The option Default allows you to enter some infor- mation as default in the answer field. If you use as default USERNAME, this will be replaced through the username of the user answering the questionnaire. Example.....: ASK 40 1 USERNAME Command.....: CAPITALIZE <on/off> Description.: If capitalize is on, all first letters of the words entered in an answer field will be capi- talized. If off, the user decides if a letter is capitalized through the use of his/her Shift(-Lock) key. Example.....: CAPITALIZE ON Command.....: CHANGECOLOR <foreground> <background> Description.: Changes colour to the given combination. Fore- ground (or textcolour) can be between 0 and 15, background between 0 and 7. See earlier in this documentation for a complete list of the col- ours. Example.....: CHANGECOLOR 14 1 -------------------------------------------------------------- SuperBBS v1.15 documentation Page 143 Command.....: CLEARSCREEN Description.: Clears the screen if user has selected CLS codes. Example.....: CLEARSCREEN Command.....: DISPLAY <"text"> Description.: Displays a text to the user. The pipe symbol '|' acts as a carriage return. Every textline should not exceed the screen width. If no '|' is given, SuperBBS will continue at the end of the last line. Use the '|' also after the GETCHOICE command as the first character of a textline. You can use as many '|' symbols behind each other as you like. Example.....: DISPLAY "Welcome to this BBS system.|" Command.....: DISPLAYASW <variable> Description.: Shows the answer given to the question given as the variable. This should be the same variable as used with the question. Example.....: DISPLAYASW 1 Command.....: DISPLAYFILE <filename> Description.: Displays the file given as filename from the textfile directory. If the user has ANSI enabled this will be the ANSI version if avail- able, otherwise the ASCII version is shown. SuperBBS first looks in the directory specified in the language file, then in the directory specified in CONFIG.EXE. Example.....: DISPLAYFILE WELCOME Command.....: DOMENUC <menutype> <"data"> Description.: This command will run the menu command (see list for numbers) given as data in the menutype field. The information given in the data field will be displayed to the user. Example.....: DOMENUC 11 "Yelling Sysop" Command.....: ENDIF Description.: Use this command as the end of an IF loop. (See the IF command.) Example.....: ENDIF Command.....: EXEC <command> Description.: Executes the program given as the command option. This allows you to execute an external program. This program should be in the path or current directory. Example.....: EXEC USERCHEC.EXE -------------------------------------------------------------- SuperBBS v1.15 documentation Page 144 Command.....: GOTO <label> Description.: This command allows you to jump to a character or value. Label must be ONE character or a value. The place GOTO will jump to is deter- mined by the same character or value preceded by a colon ':'. So the command GOTO A, will jump to :A. Example.....: GOTO B Command.....: GETCHOICE <options> <variable> [default] Description.: This command allows you to ask the user a ques- tion, with only a limited one character answer available. Options are the characters which are valid for this answer, variable is the question number the answer should be stored under in memory and default is the default answer, so when a user just presses ENTER, it will default to the answer stated in default. Example.....: GETCHOICE YN 2 Y Command.....: IF <variable = "string"> Description.: This command allows you to jump over certain parts of your questionnaire if the compiled variable does not match the given string. Vari- able is the question number stored in memory and string is the string to match. SuperBBS will compile the user's answer and compare it to the string. If this doesn't match, SuperBBS will jump to the first ENDIF found. Example.....: IF 1 = "Frank Hemmelder" Command.....: OUTPUTANSWER ["string"] <variable> Description.: This commands allow you to store the answers given by the user in an ASCII file with the same name as the questionnaire, but with an ASW extension. String is the text which should be placed in front of the answer, variable is the number of the answer stored in memory. Example.....: OUTPUTANSWER "Full name : " 1 Command.....: POSTINFO Description.: This command will write the current system time, data and the username to the answer file. This command should be used in front of the OUTPUTANSWER lines. Some programs, like READANS.EXE, allows you to upgrade newusers easily by reading the answers in the NEWUSER.ASW file, but they need the information from POSTINFO to separate the different users. Example.....: POSTINFO -------------------------------------------------------------- SuperBBS v1.15 documentation Page 145 Command.....: QUIT Description.: Ends the questionnaire. This does not mean this command has to be at the end of all the ques- tions. If you use the IF and ENDIF commands, this could be half way through your question- naire. Example.....: QUIT Command.....: SETFLAG <flag> <on/off> Description.: Allows you to change a flagsetting from the current user. Flag should be a character/number combination, flags are numbered A1 to D8, and they should be followed by the on or off com- mand. Example.....: SETFLAG B5 ON Command.....: SETSECURITY <level> Description.: Allows you to change the userlevel. Level should be the new level. Example.....: SETSECURITY 0 Command.....: WAITENTER Description.: This command displays the 'Press ENTER to continue' string and waits for the user to press the ENTER key. The 'Press ENTER....' will be done in the current language. Example.....: WAITENTER 10.3 NEWUSER.Q-A & EXPIRED.Q-A -------------------------------------------------------------- The NEWUSER.Q-A is run, when available, everytime a new user logs on to your system. Here you can ask questions like the address of the user, his/her requirements or anything else you would like to know, before you give access to your system. (An example is below.) The EXPIRED.Q-A is run everytime a user's expiration date has reached 0. In this questionnaire you can change levels, change flagsettings, tell the user how he can get his/her level back and many other things. You can use as many questionnaires as you might need, but these two are special. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 146 10.4 Questionnaire example -------------------------------------------------------------- Now let's have a look at this little example. You could use it, but I recommend you change it and make it better. It will first display a textfile to the user, stating the rules of the BBS, then ask the most important questions and asks if you are a Sysop. If you are, you'll be able to enter your BBS informa- tion. Then all answers are displayed, so the user can check them and eventually start all over if he/she made a mistake. This is an example of a NEWUSER.Q-A questionnaire. CLEARSCREEN DISPLAYFILE RULES CHANGCOLOR 11 0 CAPITALIZE ON DISPLAY "Do you still want to continue? (Y/n) " GETCHOICE YN 1 Y CAPITALIZE OFF IF 1 = "N" SETSECURITY 0 CHANGECOLOR 14 4 DISPLAY "You will be logged off now!" QUIT ENDIF :A CLEARSCREEN CHANGECOLOR 10 0 DISPLAY "|Your full name........: " ASK 40 2 USERNAME CHANGECOLOR 10 0 DISPLAY "Address................: " ASK 40 3 CHANGECOLOR 10 0 DISPLAY "City and State.........: " ASK 40 4 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " ASK 15 5 CHANGECOLOR 10 0 DISPLAY "|Are you a Sysop? (y/N) " CAPITALIZE ON GETCHOICE YN 6 N CAPITALIZE OFF IF 6 = "Y' CHANGECOLOR 10 0 DISPLAY "BBS name...............: " ASK 40 7 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " ASK 15 8 ENDIF -------------------------------------------------------------- SuperBBS v1.15 documentation Page 147 CHANGECOLOR 13 0 DISPLAY "|Thank you for filling out all the questions." DISPLAY "|Now you can check your answers.| WAITENTER CLEARSCREEN CHANGECOLOR 11 0 DISPLAY "|These are your answers: " CHANGECOLOR 10 0 DISPLAY "|Name..................: " DISPLAYASW 2 CHANGECOLOR 10 0 DISPLAY "Address................: " DISPLAYASW 3 CHANGECOLOR 10 0 DISPLAY "City and State.........: " DISPLAYASW 4 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " DISPLAYASW 5 CHANGECOLOR 10 0 IF 6 = "Y' CHANGECOLOR 10 0 DISPLAY "BBS name...............: " DISPLAYASW 7 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " DISPLAYASW 8 ENDIF CHANGECOLOR 14 1 DISPLAY "|All answers correct? (Y/n) CAPITALIZE ON GETCHOICE YN 9 Y CAPITALIZE OFF IF 9 = "N" GOTO A ENDIF CHANGECOLOR 12 0 DISPLAY "|Thank you for answering all questions." DISPLAY "|The answers are now stored." POSTINFO OUTPUTANSWER "Name.........: " 2 OUTPUTANSWER "Address......: " 3 OUTPUTANSWER "City & State.: " 4 OUTPUTANSWER "Phone........: " 5 IF 6 = "Y" OUTPUTANSWER "BBS name.....: " 7 OUTPUTANSWER "Phone........: " 8 QUIT -------------------------------------------------------------- SuperBBS v1.15 documentation Page 148 Chapter 11. Running SuperBBS ============================================================== 11.1 General information -------------------------------------------------------------- SuperBBS can be run as a stand alone program or with a front- end mailer like Frontdoor (TM), D'Bridge (TM) or any other mailer program. In both cases you need to run SuperBBS from a batchfile. Two examples are given later in a chapter of the documentation. One for running SuperBBS as stand alone program and one for running SuperBBS in combination with a mailer. If you are using SuperBBS with a mailer, please read all the documentation of the mailer program carefully, so you know how the two programs interact with each other. 11.2 Command line options -------------------------------------------------------------- SuperBBS can be started by running the program BBS.EXE without any parameter. This will put the main SuperBBS program on- line. You will see a SuperBBS screen with some information, like time and date, last user and more. When this screen is visible (or the screensaver is working) you have two options: [L] This will put the BBS program in local mode. This way you will be able to connect to the system, just like you are running the system remotely. Beware that if you have any door programs installed which uses a Carrier Detect monitor, these won't run because there is no carrier signal available. [ESCAPE] Shutdown SuperBBS and returns you to the DOS prompt. There is a third option, this is that you get a caller on- line. SuperBBS will connect at the right modem speed and will handle the connection. A carrier check is build in, so if the user disconnects, the system will restart (if run from a batchfile). To start the BBS program in local mode, use the -L option. This option and the other command line options are as follows: Type.........: -Bxxxx Description..: Starts SuperBBS with a BPS rate of xxxx. This is a value between 300 and 38400, depending on your modemspeed. This option is mostly used in a batchfile running a mailer, telling SuperBBS at what BPS rate the user is calling. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 149 Type.........: -Exxx Description..: Tells SuperBBS to exit the call with errorlevel xxx. This can be handy if you wish to start some external program after SuperBBS finishes. Type.........: -L Description..: Starts the SuperBBS program in Local mode. Type.........: -Oxxxxxx Description..: This option will increase the overlay buffer with xxxxxx bytes. (For a 286-12 Mhz machine this should be somewhere between 50000 and 100000 bytes.) Experiment a bit with it to find the right value. This will speed up the Super- BBS operation on slow machines or machines with no EMS. This option defaults to 50000 bytes. Type.........: -Px Description..: Tells SuperBBS what COM port to use for the connection. Type.........: -R Description..: Tells SuperBBS it is already connected to a caller and just has to restart the main pro- gram. This option is used after a type 15 exit. Type.........: -T Description..: Tells SuperBBS the user has -T time left. This time is forwarded by the mailer, to prevent an overshoot of an event. Frontdoor uses this in it's DOBBS.BAT file. (Frontdoor v2.01 also has a bug at 14400 EC, stating the -B command as 9600 Bps, instead of the correct Bps). See your mailer manual for further information on call- ing the BBS. Type.........: -* Description..: Tells SuperBBS not to load the overlay file in EMS. Combinations of these parameters are possible. These parame- ters are not necessary to run the SuperBBS program, but are sometimes needed. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 150 11.3 On-line Sysop keys -------------------------------------------------------------- While the SuperBBS is online and a caller is in the system, the sysop has several keys which he/she can use. All Fx keys refer to the status line which is shown at the bottom of the local screen. All keys apply to the current user on-line. All the available keys are: Type.........: F1 Description..: Shows user's information on status line. Name, city, bps rate, securitylevel, times called, time left and line number are displayed. Type.........: F2 Description..: Shows user's flags. Type.........: F3 Description..: Shows user's up/download levels and ratio. Type.........: F4 Description..: Shows chat reason (if any) and if the Sysop is available. Type.........: F5 Description..: Shows sysop comment (from SBBSUSER.EXE) and alias information. Type.........: F6 Description..: Shows the current time and date, user's phone numbers, total calls to system, number of mess- ages written and last caller. Type.........: F7 Description..: Shows the last and first time and date the user called, and the expiration date of the user. Type.........: F8 Description..: Shows the information you have set in the con- figuration program. This function key if programmable by you. Note that the maximum line length cannot be exceeded (80 characters). You can use all control codes in these two lines. Type.........: F9 Description..: Remove status lines from screen. This gives you the same view as the user. Type.........: F10 Description..: Gives information about the on-line keys -------------------------------------------------------------- SuperBBS v1.15 documentation Page 151 Type.........: ALT-C Description..: Chat with the user. A message will be displayed to the user at the start and finnish of the conversation. Type.........: ALT-E Description..: Run the on-line user editor. This allows you to edit the current user. All changes will be saved in the user file. A message will be dis- played to the user, unless you have CapsLock on. Type.........: ALT-F Description..: Change the current user's flagsettings. All changes will be saved in the user file. A mess- age will be displayed to the user, unless you have CapsLock on. Type.........: ALT-H Description..: Disconnect user without showing GOODBYE.A??. Type.........: ALT-J Description..: Shell to DOS from SuperBBS. SuperBBS can swap to EMS or disk if allowed through the CONFIG.EXE program. A message will be displayed to the user when you shell out and when you return. Type.........: ALT-L Description..: Locks the user out of your system. He/she will be disconnected and his/her level will be lowered to 0. Type.........: ALT-S Description..: Change the caller's security level. A message will be displayed to the user, unless CapsLock is on. Type.........: ALT-T Description..: Change the timelimit for the user for this call. Type.........: ALT-1 Description..: Generate line noise. This can be useful if you want a user off-line. Type.........: ALT-2 Description..: Toggle the ratio check for the current user on or off. Type.........: ALT-3 Description..: Set a new download limit for this call. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 152 Type.........: ALT-4 Description..: Generates a BEEP on the user's console. Type.........: ALT-5 Description..: Toggle output to user's screen on or off. Type.........: ALT-6 Description..: Toggle user's keyboard on or off. Type.........: Up arrow Description..: Increase time limit with 1 minute. Type.........: Down arrow Description..: Decrease time limit with 1 minute. Type.........: Scroll lock Description..: Toggle Sysop availability on/off. Status lock on means Sysop not available. Also no messages are send to the user, when the Sysop changes the user information. 11.4 User's on-line keys -------------------------------------------------------------- Just as the Sysop has the user some special keys on-line. These are: Type.........: P Description..: Pause all output from text. Type.........: S Description..: Abort current operation. This works in most places in the SuperBBS program. Type.........: Ctrl-C Description..: Stops Sysop yell and message scan. Type.........: Ctrl-Y Description..: Clears any input line. (When you have to answer a question.) As of version 1.10, SuperBBS supports the 'normal' text editor keys as usable keys at input fields. This means you can use the arrow keys, Ctrl-T, Ctrl-Y, Insert, Delete, Home and End keys while entering text. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 153 11.5 Errorlevels -------------------------------------------------------------- SuperBBS normally exits with an errorlevel. You can influence the 'normal' exit through the -Exxx command parameter (see above), but there are some more errorlevels reserved for SuperBBS. Here they are: Errorlevel...: 0 Description..: Normal exit, no problems encountered. Errorlevel...: 2 Description..: Sysop dropped to DOS by pressing ESCAPE in stand alone mode. Errorlevel...: 3 Description..: User logged off and entered Netmail. Errorlevel...: 4 Description..: User logged off and entered Echomail. Errorlevel...: 5 Description..: User logged off and entered both Net and Echo- mail. In general it is useful not to use the errorlevel of 10 and below. These levels are mostly used to control program behav- iour. 11.6 Yell and chat -------------------------------------------------------------- SuperBBS has a chat option build in to the main program. When a user tries to yell for you, the SuperBBS program will ask for a reason. Then, if a reason is entered, the system will page you. Normally this is a creeping siren sound, but you can choose a melody through the use of YELLCFG.EXE. This program allows you to choose a page melody. You can even write your own tune, check the SBBSYELL.CFG file for an example. If you want to randomly change the tune every day, run the following option in your daily maintenance: YELLCFG.EXE CHANGE. This will take a different melody from the list every time it is run. The chat will be in two colours and if ANSI available it will be full screen by default. One window for the Sysop and one for the user. (Naturally only when user has ANSI on.) If the Sysop starts a chat, the user will get all the time spent in the chat back after ending the chat. If the user starts the chat, the time will continue. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 154 If you don't want the full screen chat, press the Left-Shift key, while pressing Alt-C or when you answer the chat. SuperBBS will display an ANSI/ASCII file before the user is asked for the reason to chat. This file is called PAGEQUES.A?? and should be in your textfile directory. Five keys are available during a chat: Type.........: Ctrl-A Description..: Toggle capture file on/off Type.........: Ctrl-B Description..: Display an ANSI/ASCII file Type.........: Ctrl-Y Description..: Clears current line Type.........: Ctrl-R (in Fullscreen chat) Description..: Redraws the screen Type.........: Ctrl-W (in Fullscreen chat) Description..: Clears the your window The Sysop can end the chat with the ESCAPE key. Through the Ctrl-A key is it possible to keep a capture file for later reviewing of the chat. 11.7 Alias system -------------------------------------------------------------- SuperBBS allows a full alias system. The Sysop can select the use of an alias in all message areas. (Most echomail areas don't allow aliases.) Mailcheck at logon or after a menu type 22 command, will be done for the user's real and alias name. No double aliases are allowed and SuperBBS checks this after a caller enters an alias. SuperBBS includes an option to view a list with real names and their aliases. The alias system only works if you set the option in the CONFIG.EXE program to Yes. 11.8 View a certain file -------------------------------------------------------------- An option in the user record is the field: File to view. Here you can specify per user a file which will be displayed to the user. You can select this file through the use of the SBBSUSER.EXE program. There is an option to allow the file to be deleted after viewing and only showing the file once. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 155 11.9 Menu to run -------------------------------------------------------------- SuperBBS allows users to enter the system at another menu then the TOP.MNU menu. In the SBBSUSER.EXE program is a field for this option. Here you can enter the name of the menu the user wants to start at. SuperBBS will then pass the user directly to the menu given in the MenuToRun field. This menu can be different for every user. There is currently no automatic way to do this. You will have to adjust the userrecord yourself if you want this option available to your users. The configuration program allows you also to specify a menu to run, instead of the normal TOP.MNU. The option in the userrecord will however override the function in the configuration program. 11.10 Expiration system -------------------------------------------------------------- SuperBBS has an expiration system build in. There is a field in the SUSERS.BBS to store the date the expiration has to end. You could use this system to notify members of the expiration of their membership or something like that. When the date of expiration is reached and the user logs on again, he/she will see the questionnaire EXPIRED.Q-A, if available. In this file you can change the userlevel, flag- settings and other information. There is an option to add a certain amount of days to a new- user record. See the configuration part for more information. Two new control codes are available to display the expiration date ^K# and the days till expiration ^F$. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 156 Chapter 12. Multitasking and multiline ============================================================== 12.1 General information -------------------------------------------------------------- SuperBBS is able of running a system with more lines. We ask everybody who uses SuperBBS to give their opinion and ideas. That way we can expand and improve the multi-node option. SuperBBS currently uses 250 KByte memory per line. The setup explained here is for a system running a multitasker like Desqview or a system using a network, although drive names could change in a network configuration. 12.2 Multiline configuration -------------------------------------------------------------- The directory setup for the multi-node operations is a bit different from the single line systems. You will have to make a directory for every node you plan to run, even if it's only a local node. Your directory setup could look like this: C:\SBBS C:\SBBS\LINE1 C:\SBBS\LINE2 C:\SBBS\LINE3 C:\SBBS\MAIL C:\SBBS\TEMP1 C:\SBBS\TEMP2 C:\SBBS\TEMP3 C:\SBBS\WORK1 C:\SBBS\WORK2 C:\SBBS\WORK3 C:\SBBS\NODELIST (Optional) C:\SBBS\ATTACH (Optional) E:\ Place the executable programs in the SBBS directory and set your path statement pointing to this directory. You will have to setup a TEMP directory and a WORK directory for every line in use. The E:\ drive is a RAM disk and is the common directory for all nodes. You can also use a normal disk if no RAM drive is available. But a RAM disk is faster. Go into the line1 directory and start the config.exe program. The configuration program will start and you can setup all information needed, including file areas and limits. After you have finished, you will find some configuration files in your line1 directory. If you plan to use one single file area configuration list and one single limits configuration list, move the FLSEARCH.CTL and LIMITS.CTL files to the main direc- tory. Their they are accessible by all different lines. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 157 Now enter the second line directory and run config again. An option is to copy all files from the line1 directory to the second, third..... directory and then change the settings in the config by running the configuration program. You will have to change at least the directory setup. If using one single FLSEARCH.CTL and LIMITS.CTL file (see above), delete these files created in the line2 and line3.... directories. Config will create the FLSEARCH.CTL and LIMITS.CTL everytime you access the Limits and file area part of the configuration. If you like to change something in the two files, you first have to move them to one of the line directories, otherwise the files are newly created. You will have to create a LANGUAGE.CTL file in every line directory. These can all be the same or can differ from line to line. The *.LNG files you use can all be placed in the main SuperBBS directory. You now have to create the menu and textfiles. This is done in the same way as with a single line, although there are some special points to watch. When using a type 7 exit, you will have to tell the external program which line it is using. Have a look at the type 7 optional data menu options for more information on this sub- ject. Most used command would be *N, telling the program which node it is running on. SuperBBS allows the use of the file DORINFO?.DEF, instead of the standard DORINFO1.DEF. The ques- tion mark will be replaced by the node number. When finished with the menus and textfiles, you can try the BBS by going into a line directory and entering BBS -L -N? (where the ? is the line number your working on). This will start the SuperBBS program in local mode on line?. You will now have to setup the multitakser, or the network software, to run the system multiline. Check your manual from the multitasker and/or network for more information on this subject. Please note that some external doors for SuperBBS can't handle the multiline setup. You might have to set up the program separately for every line. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 158 12.3 Multitaskers & networks -------------------------------------------------------------- SuperBBS has been tested with these multitaskers (All trade- marks of their respective owners): - Desqview 2.25 (Normal and 386 versions) - Desqview 2.31 - DoubleDos 4.0 - Windows 3.0 - Windows 3.1 (Beta) SuperBBS support multitasking with Desqview. It will release time slicks and SBBSUSER will ask from Desqview what memory to use for direct screen writes. SuperBBS has been tested with a Lantastic (TM) network and a Novell Light (TM) network. 12.4 Message base locking -------------------------------------------------------------- SuperBBS has a message base locking system. It is available on request from the SuperBBS headquarters for third party pro- grammers. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 159 Chapter 13 Specific external SuperBBS utilities ============================================================== 13.1 General information. -------------------------------------------------------------- SuperBBS comes with a few external programs. These are: - USERPACK.EXE - SBBSUSER.EXE - SBBSUTIL.EXE - SBBSMENU.EXE - STOP.EXE - SBBSNODE.EXE _ SNETMGR.EXE These programs are specially written for the use with Super- BBS. Other programs are available, but do not always support all SuperBBS functions. 13.2 USERPACK.EXE -------------------------------------------------------------- This program is designed to clean your user database. It will delete all users from the USER.BBS and SUSER.BBS files who have the DELETE flag on. The only exception are user's with the NO-KILL flag on. It will also pack your userdatabase for faster processing. Userpack allows multiple commandline parameters, but all parameters are optional. These are the available options: Type.........: -B Description..: Makes backup of the user files. This will take the program longer to run than without this option. Type.........: -Dxxx Description..: Deletes users from the list who haven't called in xxx days. Type.........: -O Description..: Don't make backup copies if there is not enough diskspace. Use this command in combination with the -B option. Type.........: -R Description..: Removes backup copies after run is complete. Type.........: -Sxxx Description..: Deletes users with a securitylevel lower than xxx. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 160 Type.........: ? Description..: Gives a short help screen. Use only as single command line option. If you run userpack without any options, it will just pack your user base and delete every user with the DELETE flag on. 13.3 SBBSUSER.EXE -------------------------------------------------------------- This is the user editor for SuperBBS. You will be able to edit all available information in the user record. It is a full- screen program, with the function keys it uses displayed on the bottom line. Their are two modes (or windows). Edit mode and the main window. Edit mode allows you to change informa- tion from a caller. The main window is the command centre of the program. Here all function keys are active. From here you go to the edit window. These are the available keys: Key..........: Cursor keys Description..: Move around in the editmode of the program. This will move you from edit field to edit field. Key..........: Escape Description..: If in editing mode will ask you if you want to save the information and leave the edit mode. If in the main window, it will exit you to DOS. Key..........: Home Description..: Will move you to the first user when in the main window. Key..........: End Description..: Will move you to the last user when in the main window. Key..........: PgUp Description..: Will move you 10 users forward when in the main window. Key..........: PgDn Description..: Will move you 10 users backwards when in the main window. Key..........: F1 Description..: Display help screens for SBBSUSER. Key..........: F2 Description..: Goto general edit mode. This allows you to change most information available. Changing the security level fast is possible with the ALT-S option. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 161 Key..........: F3 Description..: Search for the user in the NEWUSER.ASW file and display his/her answers. Useful if you want to update users. Key..........: F4 Description..: Search option. This allows you to search for part of a name, alias or city. Key..........: F5 Description..: Put current user in window in the TRASHCAN.CTL file. Key..........: F6 Description..: Add a new user to the database. Key..........: F7 Description..: Change the user's colour configuration. Key..........: F8 Description..: Change the user's flagsettings. Key..........: F9 Description..: Change the user's attributes. The delete flag can also be set from the main window through the ALT-D key. Key..........: F10 Description..: Exit the program. Key..........: Shift-F1 Description..: Add user to the VIP.CTL list. Key..........: Shift-F4 Description..: Change the number of calls With the numerical keys you can select an userrecord. Just enter the number of the record your looking for. SBBSUSER.EXE let's you edit the USER.BBS and SUSER.BBS file. Other user editors mostly allow only editing of the USER.BBS file. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 162 13.4 SBBSUTIL.EXE -------------------------------------------------------------- SBBSUTIL.EXE allows you to convert some SuperBBS files to general QuickBBS type files. This is useful for some external programs which can't handle the specific SuperBBS type files. The program also gives you the option to initialize your file directories. All commands are done through the use of command- line parameters. Start the program as follows: SBBSUTIL.EXE <parameter> The parameters are: Type.........: FLSEARCH Description..: Converts SuperBBS FLSEARCH.BBS to FLSEARCH.CTL, which can be used with RemoteAccess and/or QuickBBS utilities. Type.........: LIMITS Description..: Converts SuperBBS LIMITS.BBS to LIMITS.CTL. Type.........: INITFILEAREAS Description..: Will initialize all file areas listed in the file FLSEARCH.BBS. Here you can use three extra parameters: -F Make FILES.BBS files if not available. -D Make DIR.BBS files if not available. -A Add all missing files, files which are in the directory, but not in the FILES.BBS list, to the FILES.BBS list. Type.........: NODESTATUS Description..: Change the status of a node. You can set it to 'Down' or 'Waiting for call'. The commandline for this program is: SBBSUTIL NODESTATUS <Line#> <Option> Option can be 1 for 'Down' or 2 for 'Waiting for call'. Running the util program with the option: SBBSUTIL.EXE <parameter> ? will display a little help screen for the available options. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 163 13.5 USERSORT.EXE -------------------------------------------------------------- Usersort is a utility to sort your userbase. This can be done in several ways. The available options are: -L Sort on lastname -F Sort on firstname -S Sort on userlevel -D Sort in descending order Normally ascending sort order is used. The program will take more then one command option. Example: USERSORT -S -L -F -D will sort your userbase on security, if these are the same on lastname, if these are the same on firstname. It will start at the highest level and will end at the lowest. 13.6 SBBSMENU.EXE -------------------------------------------------------------- New with this release of SuperBBS is the SBBSMENU.EXE program. This is a complete menu editor for SuperBBS. It supports the multi-language aspects of SuperBBS. When you start the pro- gram, it should be in your directory containing the configur- ation files, you will be presented with the TOP.MNU menu if available. Otherwise you will start in a new menu. Pressing [ESC] will display the menu. This menu has the fol- lowing options: Command......: Files Description..: Here you will be able to save, load, copy files and do other maintenance functions. Command......: Text Description..: Here you will find the options which work on the textpart of the menu. Command......: Commands Description..: Here you will find the options which work on the menu options from the menu. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 164 Command......: Prompt Description..: Commands for the prompt, which will be visible underneath the menu. Command......: Setup Description..: Setup commands for the menu editor. All menu commands will be described in detail below. 13.6.1 File commands -------------------------------------------------------------- Here are the commands you will find, when you enter the file menu of the SuperBBS menu editor. Command......: Load menu Description..: Loads a menu from the directory specified in the current language file. You will be pres- ented with a box stating what to look for. (Mostly *.MNU files.) Enter the value you want, or press ENTER and the editor will display a list of the available menus. With the cursor keys you can select a file. Pressing ENTER will load the file. Command......: Save menu Description..: Saves the menu you are currently working on. Command......: New menu Description..: Start building a new menu. The editor will ask you for a menu name. Command......: Write to Description..: Write the menu file to a specified name. This option is useful if you want to use a menu to build another. This way you can save a menu with a different name. Command......: Rename Description..: Rename a menu in the directory. The editor will ask you which menu to rename. Command......: Copy Description..: Copies a menu to another name. The editor will ask you for the name of the menu to copy. Command......: Language Description..: Changes the language currently in use. This allows you to quickly change menus for all languages, without leaving the editor. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 165 Command......: DOS Shell Description..: Shell temporarily to DOS. You need to type EXIT to return to the editor from DOS. Command......: Exit to DOS Description..: Exits the menu editor. 13.6.2 Text commands -------------------------------------------------------------- Command......: Edit text Description..: Change the text of the menu. Pressing ALT-F10 while in the text editor will display a help- file. Command......: Simulate text Description..: The editor will show you what your menu will look like if a user would see it. You will have to enter a security level and flagsetting. Command......: Clear text Description..: Clears the current text screen. Command......: View text Description..: View a text belonging to the menu. This option allows you to see files which are not part of the menu, but will be displayed through the ANSI/ASCII display file option in the menu. Command......: Run editor Description..: Enter an ANSI or ASCII text editor as you have described in the setup of the SuperBBS menu editor program. When you press ALT-F10 while you are in text edit, a help menu will be displayed. Here you will find all the commands avail- able to you. The use of extended ASCII characters is supported, so you can design lines and other graphics. 13.6.3 Menu Commands -------------------------------------------------------------- This is the important part of the SuperBBS editor. Here you specify the menu commands. You will find the following com- mands in this menu: Command......: Edit menu Description..: Edit a menu file. Here you enter the menu type, securitylevel, hotkey and optional data. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 166 Command......: Text dump Description..: Dump the text to a printer. Command......: Menu dump Description..: Dump the menu information to a printer. When you press ALT-F10 while you are in menu edit, a help menu will be displayed. here you will find all the commands avail- able to you. Entering a menu is done through dialogue boxes for the menu type. If a menu type is not available in the menus given, you can use the option for 'other' menu types. 13.6.4 Prompt -------------------------------------------------------------- This menu option allows you to edit the prompt which is shown to the user. These commands are available: Command......: Edit prompt Description..: Change the text of the prompt. You can use control codes in the prompt if you want. Command......: Change colours Description..: Change the colours of the prompt. 13.6.5 Setup -------------------------------------------------------------- This option allows you to setup the menu editor. You can specify an ANSI and ASCII text editor and the default prompt. The text editors will be called if you want to edit a text- file, so make sure they are in your path, or you specified the complete name. 13.7 SBBSNODE.EXE -------------------------------------------------------------- As of version 1.15, SuperBBS has nodelist support build in. It isn't a 100 % yet, the cost aspect isn't supported yet, but it is working. Before you can use the nodelist with SuperBBS, you will need to compile two index files. This is done with the SBBSNODE.EXE program. This program will create the files NODEINC.SBS and NODEIDX.SBS. Make sure you have set the directory settings correctly in the configuration program. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 167 SBBSNODE.EXE can compile up to 10 different nodelists. It will automatically search for the NODELIST.??? file and compile it. You can give the other files to compile as extra commandline options. Here is an example: SBBSNODE SUPERNET SIGNODES This will compile the latest NODELIST.???, SUPERNET.??? and SIGNODES.??? nodelists. Run the nodelist program every time you update your nodelists. This is very important. 13.8 SNETMGR.EXE -------------------------------------------------------------- This program has two functions. One for multiline systems and one for all systems. When run for the first time, you will be prompted for an ASCII editor, like Q.EXE. If you ever want to change the editor, delete the SNETMGR.CFG file. 13.8.1 Users online -------------------------------------------------------------- This function of the SNETMGR.EXE program is only of use to multiline systems. It allows you to see the users online in every node, send messages to any combination of users or force any combination of nodes down with a selected errorlevel. The following keys are available: [CURSORKEYS] Move around the nodes [SPACE] Tag/untag node [S] Send message to node [D] Force node down with errorlevel When forcing a node down, SNETMGR.EXE will ask you for the errorlevel to use to exit. ESCape will return you to the menu. Run the program from the line directories when you are running a multiline system. Otherwise the program will give the error- message that the file SCONFIG.BBS is not found. 13.8.2 Last callers -------------------------------------------------------------- The second option allows you to view the last 15 callers and todays callers of your system. The program can also give you some information about the BPS rates used on your BBS. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 168 Chapter 14 Useful information ============================================================== 14.1 Batchfiles -------------------------------------------------------------- To run SuperBBS you will need a batchfile. Two examples are given. The first is a short one for running SuperBBS in stand alone mode. The second is from a system with a Frontdoor mailer. This is the stand alone version: @echo off :start bbs if errorlevel 2 goto end goto start :end echo SysOp dropped to dos Nice and simple. Start the batch file and the screen will be cleared. After that SuperBBS is started. If the Sysop presses the ESCAPE key, SuperBBS will exit with errorlevel 2, which will end the batchfile. Otherwise SuperBBS is restarted. See your DOS documentation for more information about batch files and errorlevels. The @echo off only works in DOS 3.3 and higher. Otherwise just leave the @ off. Here's a bigger example. This batchfile is taken from a run- ning system. The system is running SuperBBS with Frontdoor as a mailer and ZmailH as the net/echomail processor. First the CD-Rom is tested. This makes sure the CD-Rom will be available when called upon from SuperBBS. Then Frontdoor is started. Depending on the errorlevel of the exit from Front- door, will the BBS be started or an event will be executed. Errorlevels 117 to 124 represent the different modemspeeds. These errorlevels are set in the configuration program of Frontdoor. Errorlevel 116 is a local logon, executed through the use of a function key in Frontdoor. Errorlevel 110 is executed when it is time for the event, mostly run in the early hours of the day. Errorlevel 125 is used when mail is received by Frontdoor. The system is using two different limits.ctl files, one for the hours between 18:00 and 24:00 hours and one for the other time period. They are copied at two events in Frontdoor, errorlevel 105 and 104. The second part in this batchfile with errorlevels is the part where SuperBBS will exit to after a type 15 exit and after the user logged off. Depending on the errorlevel a certain action is taken. If the user logged of, Frontdoor will be started -------------------------------------------------------------- SuperBBS v1.15 documentation Page 169 again. If it was a type 15 exit, an external program is started. After the external program SuperBBS will restart with the -R option and again return to the errorlevel part when the user logged off, or used another type 15 exit. rem Batchfile NNN SuperBBS - may 1991 rem Last revised: 12-06-91 @echo off :cdrom dir d:\ :start cd\mailer fd.exe if errorlevel 125 goto mail if errorlevel 124 goto 38400bps if errorlevel 123 goto 19200bps if errorlevel 122 goto 38400bps if errorlevel 121 goto 19200bps if errorlevel 120 goto 9600bps if errorlevel 119 goto 4800bps if errorlevel 118 goto 2400bps if errorlevel 117 goto 1200bps if errorlevel 116 goto local if errorlevel 110 goto maint if errorlevel 105 goto avond if errorlevel 104 goto dag if errorlevel 10 goto end if errorlevel 1 goto error goto end :38400bps cd\bbs\line1 bbs -N1 -B38400 goto afterbbs :19200bps cd\bbs\line1 bbs -N1 -B19200 goto afterbbs :9600bps cd\bbs\line1 bbs -N1 -B9600 goto afterbbs :4800bps cd\bbs\line1 bbs -N1 -B4800 goto afterbbs -------------------------------------------------------------- SuperBBS v1.15 documentation Page 170 :2400bps cd\bbs\line1 bbs -N1 -B2400 goto afterbbs :1200bps cd\bbs\line1 bbs -N1 -B1200 goto afterbbs :local cd\bbs\line1 bbs -l -N1 goto afterbbs :mail echo ath1 > com2 cd \bbs zmailh QB PU PI PA PS EI ES EE EF EP NI mbutil link goto start :dag cd \bbs copy tijd1.bbs limits.bbs goto start :avond cd \bbs copy tijd2.bbs limits.bbs goto start :maint echo ath1 > com2 cd\bbs copy users.bbs users.fh copy susers.bbs susers.fh mbutil purge -file mbutil.bbs mbutil index -renumber -delete mbutil pack -renumber -overwrite mbutil link zmailh C userpack -D90 -S5 usersort -S -F -L -D fast /s maf copy \bbs\line1\config.bbs \bbs\config.bbs dbest c:\bbs\text-uk\top-uplf NNN_SuperBBS 200 u25 dbest c:\bbs\text-uk\top-dowf NNN_SuperBBS 200 d25 dbest c:\bbs\text-uk\top-uplk NNN_SuperBBS 200 r25 dbest c:\bbs\text-uk\top-dowk NNN_SuperBBS 200 s25 dbest c:\bbs\text-uk\top-call NNN_SuperBBS 200 c25 -------------------------------------------------------------- SuperBBS v1.15 documentation Page 171 dbest c:\bbs\text-uk\top-mess NNN_SuperBBS 200 m25 dbest c:\bbs\text-uk\top-area NNN_SuperBBS 200 b25 dbest c:\bbs\text-uk\top-syst NNN_SuperBBS 200 i delete \bbs\config.bbs boot goto start :afterbbs if errorlevel 250 goto start if errorlevel 152 goto upload if errorlevel 151 goto download if errorlevel 150 goto xpress if errorlevel 5 goto both if errorlevel 4 goto echomail if errorlevel 3 goto netmail if errorlevel 1 goto end goto start :restartbbs cd\bbs\line1 bbs -R -N1 goto afterbbs :both echo ath1 > com2 cd\bbs zmailh QB EE EF EP PA NE goto start :echomail echo ath1 > com2 cd \bbs zmailh QB EE EF EP PA goto start :netmail echo ath1 > com2 cd\bbs zmailh QB NE goto start :xpress cd\xpress xpmail -P2 -F -B38400 -DISF -NC goto restartbbs :upload cd\xpress xpmail -P2 -F -B38400 -DISF -NC -U goto restartbbs -------------------------------------------------------------- SuperBBS v1.15 documentation Page 172 :download cd\xpress xpmail -P2 -F -B38400 -DISF -NC -DAP goto restartbbs :error echo Systeem error !! :end echo ath1 > com2 echo NNN SuperBBS down. This is an example of a batchfile which has two lines available. That's why you see the -N1 option on the BBS.EXE lines. If you run a single line, this option is not needed. Hope that this example gives you some inside views on running a mailer and SuperBBS. This file is only an example, although it is based upon a running system. Consult your DOS manual for more information on batchfiles. Also found in the documenta- tion of most mailers are examples of running a (Quick)BBS system. 14.2 Equipment -------------------------------------------------------------- SuperBBS has been tested with a wide variety of machines, ranging from a simple XT to a 80486-33 Mhz, and software, including MS-Dos 5.0 (TM), JP Software 4DOS 4.00 (TM) and Desqview (TM). If you have any trouble running a certain combination of hardware and/or software, contact the support nodes. They might be able to help, or give you information on how to obtain help. 14.3 Turbo Pascal errors -------------------------------------------------------------- SuperBBS is written in Turbo Pascal. Here are some Turbo Pascal errors. If you receive a message like: Runtime error: ???? It means an error occurred. The following list might help you to discover what went wrong. Code.........: 2 Description..: File not found Solution.....: You've deleted a SuperBBS file and SuperBBS can't find it. Check which file is possibly missing and replace it. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 173 Code.........: 3 Description..: Path not found Solution.....: You've configured a non existing path in the configuration. Check your setup. Code.........: 4 Description..: Too many open files Solution.....: MsDos 'Files=??' statement in config.sys is too low, increase the value. You will need to re- boot your computer. Code.........: 5 Description..: File access denied Solution.....: You've used a Hidden/ReadOnly attribute with a SuperBBS file. Don't do that! Code.........: 15 Description..: Invalid drive number Solution.....: You've configured an illegal drive in the con- figuration. Code.........: 100 Description..: Disk read error Solution.....: Your hard disk has problems, check it. Code.........: 103 Description..: File not open Solution.....: Problems with open/close/read files, try to increase 'Files=??' statement first. Code.........: 150 Description..: Disk write protected Solution.....: You've a write protected disk, don't do that. Code.........: 151 Description..: Unknown unit Solution.....: You've configured an illegal unit/drive in the configuration. Code.........: 152 Description..: Drive not ready Solution.....: Problems with your disk drive, check it. Code.........: 156 Description..: Disk seek error Solution.....: Problems with your disk drive, check it. Code.........: 157 Description..: Unknown media type Solution.....: Operating system doesn't recognize your disk drive's format. Check it. -------------------------------------------------------------- SuperBBS v1.15 documentation Page 174 Code.........: 158 Description..: Sector not found Solution.....: Problems with your disk drive, check it. Code.........: 162 Description..: Hardware failure Solution.....: Problems with your hardware, check it. Code.........: 200 Description..: Division by zero Solution.....: Program error, inform authors. Code.........: 202 Description..: Stack overflow error Solution.....: Program error, inform authors. That's it. For more information about these errors, refer to the Turbo Pascal manuals, or contact the nearest SuperBBS help support or the authors. 14.4 Credits -------------------------------------------------------------- All names and programs mentioned in this documentation are copyrighted by their owners. Please observe the rules to use these programs and register them if needed. Shareware can't live without your support. Do not use illegally obtained soft- ware. We thank every writer of software available to SuperBBS for his/her contribution. Keep up the good work! -------------------------------------------------------------- SuperBBS v1.15 documentation Page 175 Chapter 15 SuperNet ============================================================== SuperNet is an elite network joining SuperBBS bulletin board systems all over the world. It is a direct connection to the SuperBBS group, documentation writer and users alike to dis- cuss SuperBBS operations and development, watch for program and utilities updates or just a place to chat about SuperBBS. SuperNet will make a nice addition to your local SuperBBS bulletin board system. Currently SuperNet is available in the following countries: - Finland - Sweden - Denmark - Norway - USA - Canada - Germany - The Netherlands - Japan - Taiwan - Switserland For more information concerning SuperNet, send a Crash netmail to SuperBBS Support Sweden, Fidonet 2:203/111 or SuperNet 42:1003/101, telephone **.46.31.312461. Poll again 24 hours later for a reply. Or you can contact a SuperBBS system con- nected to SuperNet in a country already connected. SuperNet nodes are using the 42:xxxx/xxxx node numbers. The Northern America sites are using net 43 for their nodenumbers. Net 44 is used for the BBS nodes in Japan and Taiwan. Most SuperNet systems have the nodelist available for down- load. Ask a SuperBBS Support site for one, if you can't find a nodelist from SuperNet near you. There are several echomail areas available in SuperNet. Most of these areas are available to all users and Sysops of the Bulletin Board System. Here's a short overview: Area.........: SBBS_INT Description..: SuperNet echomail about all kinds of subjects, not necessarily about SuperBBS. Available to.: Sysops and users -------------------------------------------------------------- SuperBBS v1.15 documentation Page 176 Area.........: Superthoughts Description..: SuperNet echomail for chit chat. Subject is free. (Except for personal attacks and commer- cials). Available to.: Sysops and users Area.........: SBBS_BUGS Description..: SuperNet echomail for reporting bugs in Super- BBS. Replies can be given as long they concern the subject. Available to.: Sysops (write access) Area.........: SBBS_TIPS Description..: SuperNet echomail for tips and hints about SuperBBS. Replies can be given as long they concern the subject. Available to.: Sysops (write access) Area.........: SNET_INT Description..: SuperNet READ ONLY echomail area with news from the SuperNet coordinators and the SuperBBS team. Available to.: Sysops (READ ONLY) More areas are available, this is only a small sample of the current areas. Most countries have their own national echomail areas available. Join an elite network, join SuperNet! -------------------------------------------------------------- SuperBBS v1.15 documentation Page 177 Appendix A Menu list ============================================================== Menu Description Page ------ ---------------------------------------------- ------ 0 Text line 095 1 Goto new menu 096 2 Gosub new menu 096 3 Return from last gosub 096 4 Goto new menu and clear gosub stack 097 5 Display .ANS/.ASC file 097 6 Selection menu 097 7 Shell to dos 098 8 Version and copyright notice 099 9 Logoff from system 099 10 Display system usage graph 099 11 Page the Sysop 100 12 Execute questionnaire 100 13 List/search userlist 100 14 Time statistics 100 15 Exit to DOS with errorlevel 101 16 Change city and state 101 17 Change password 101 18 Change screenlength 101 19 Toggle screen clearing 101 20 Toggle more prompt 101 21 Toggle ANSI graphics 101 22 Scan for personal mail 102 23 Read messages 102 24 Scan messages 102 25 Quick scan messages 102 26 Delete messages 102 27 Write messages 103 28 Select combined message areas 103 29 Move a file 103 30 MS-Dos directory list 103 31 List FILES.BBS 104 32 Download file 104 33 Upload file 104 34 View archived file 105 35 Search for file by keyword 105 36 Search for file by filename 105 37 List new files on system 105 38 Type a textfile 105 39 Display a textfile 105 40 Display .ANS/.ASC file with Hotkey enabled 106 41 Toggle fullscreen editor 106 42 RESERVED - Do not use 43 RESERVED - Do not use 44 RESERVED - Do not use 45 Display .ANS/.ASC file with 'Press ENTER' 106 46 Show GIF resolution 107 -------------------------------------------------------------- SuperBBS v1.15 documentation Page 178 Menu Description Page ------ ---------------------------------------------- ------ 47 Write entry in system logfile 107 48 Download specific file 107 49 RESERVED - Do not use 50 RESERVED - Do not use 51 RESERVED - Do not use 52 RESERVED - Do not use 53 Toggle mailcheck at logon 107 54 Toggle newfiles check at logon 108 55 Show BBS list (Short) 108 56 Add BBS to BBS list 108 57 Leave comment for next user 108 58 Show callers 108 59 Change colour configuration 108 60 Extract files 109 61 Archive files 109 62 Delete files 109 63 Show BBS list (Long) 109 64 Change BBS information in BBS list 109 65 Delete BBS information in BBS list 110 66 Download BBS list 110 67 Change user's phonenumber(s) 110 68 Select message area from list 110 69 Select/Pick file area from list 110 70 Change alias 111 71 List aliases 111 72 Show user's balance in timebank 111 73 Deposit time in timebank 111 74 Withdraw time from timebank 111 75 User online 111 76 Send message to other line 111 77 Change current language 112 78 Toggle 'Do not disturb' flag 112 79 Toggle fullscreen message viewer 112 80 Display areas with unread mail 112 81 Perform viruscheck 112 82 Download QWK packet 112 83 Upload QWK replies 113 84 Update lastreadpointer 113 85 Show aphorism 113 86 Execute door in template 114 87 Select door from list 114 88 Browse nodelist 114 89 Area by area combined read 114 90 Attach file to other user 115 91 Check for attached files 115 92 Select archiver to use with QWK 115 -------------------------------------------------------------- SuperBBS v1.15 documentation Page 179 Appendix B Bugreport and Suggestion form ============================================================== Suggestions form. Send this to the SuperBBS HQ in Finland. Date..................: ... - ... - 19 ... Name..................: ____________________________________ Address...............: ____________________________________ ____________________________________ ____________________________________ BBS name..............: ____________________________________ BBS telephone nr......: ____________________________________ My suggestion is : ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ -------------------------------------------------------------- SuperBBS v1.15 documentation Page 180 Bugreport form. Send this to the SuperBBS HQ in Finland. Date..................: ... - ... - 19 ... Name..................: ____________________________________ Address...............: ____________________________________ ____________________________________ ____________________________________ BBS name..............: ____________________________________ BBS telephone nr......: ____________________________________ The bug found is : (Please be as clearly as possible) ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ -------------------------------------------------------------- SuperBBS v1.15 documentation Page 181 >> End of the documentation << >> This documentation has more than 10.000 lines of text << -------------------------------------------------------------- SuperBBS v1.15 documentation Page 182